JinDaGe - ableton-copilot-mcp MCP Details

article

README

🚀 能力登-copilot-mcp

基于 ableton-js 的 MCP（模型上下文协议）服务器，用于实时交互和控制 Ableton Live，协助音乐制作人高效完成音乐创作。

🚀 快速开始

在使用本项目前，请确保已完成以下步骤：

安装 Node.js：确保 npx 命令可用。建议从 Node.js 官方网站安装最新稳定版本。
安装 MIDI 远程脚本：按照 ableton-js 项目中的说明安装 AbletonJS MIDI 远程脚本到您的 Ableton Live 中。
确保 Ableton Live 已启动并运行。
确保启用 AbletonJS 控制面板：

路径：设置 -> 链接、节拍和 MIDI -> MIDI -> 控制面板

图 1：在 Ableton Live 中启用 AbletonJS 控制面板
使用 MCP 客户端连接，包括但不限于：
- Cursor
- Cherry Studio
- Claude Desktop

Cursor 配置示例

在 Cursor 中配置 ableton-copilot-mcp：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "ableton-copilot-mcp"
    ]
}

✨ 主要特性

🎵 歌曲控制

获取歌曲基本信息（根音、音阶名称、节拍、歌曲长度等）
获取所有轨道的列表
创建 MIDI、音频和返回轨道
删除和复制轨道

🎹 轨道管理

获取轨道中的所有片段
创建空的 MIDI 片段
设置轨道属性（静音、颜色、名称、启用录音、独奏等）
将 MIDI 片段复制到指定轨道

🎼 片段操作

在钢琴卷视图中获取片段
获取并管理片段中的所有音符
添加、删除和替换片段中的音符
设置片段属性（名称、颜色、循环、loop_start、loop_end 等）

🎧 音频操作

支持基于时间范围录制轨道内容

📦 安装指南

安装 Node.js：确保 npx 命令可用。建议从 Node.js 官方网站安装最新稳定版本。
安装 MIDI 远程脚本：按照 ableton-js 项目中的说明安装 AbletonJS MIDI 远程脚本到您的 Ableton Live 中。

💻 使用示例

基础用法

在 Cursor 中配置 ableton-copilot-mcp：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "ableton-copilot-mcp"
    ]
}

📚 详细文档

兼容性测试

兼容性主要取决于 ableton-js 库支持的版本。 | Ableton Live 版本 | 测试状态 | |--------------------|-----------| | 12.1.10 | ✅ 已测试且正常工作 | | 11.x | 待测试 | | 10.x及以下 | 不支持 |

贡献

欢迎贡献！请参考贡献指南。

开发

要开发，请克隆仓库并运行：

npm install

然后在主文件中进行修改：

node index.js

📄 许可证

本项目受 MIT 许可证保护。

ableton-copilot-mcp