ableton-copilot-mcp
基于ableton-js构建的 MCP（模型上下文协议）服务器，用于与 Ableton Live 进行实时交互和控制，致力于协助音乐制作人进行音乐制作。
🎯 注意
作为一名音乐制作人，我对使用 Ableton 进行音乐创作有一定的了解。在创作过程中，我们经常需要处理各种繁琐的操作，例如人性化音符属性、合并音符、将一个音轨录制到另一个音轨等等。以前，我们只能依赖宿主 DAW 提供的功能来完成这些操作。然而，随着大型语言模型和 MCP 的出现，我们拥有了让 AI 辅助自动化的可能性。虽然 AI 直接生成音符或创作一首完整的歌曲（它无法生成一首好听的歌曲）仍然不太现实，但让 AI 辅助我们进行一些辅助操作，代表了一种新的可能性。
🚀 功能
🎵 歌曲控制
- 获取歌曲的基本信息（根音、音阶名称、节奏、歌曲长度等）
- 获取所有曲目的列表
- 创建 MIDI、音频和返回轨道
- 删除和复制曲目
🎹 轨迹管理
- 获取轨道中的所有剪辑
- 在排列视图轨道中创建空的 MIDI 剪辑
- 根据提供的示例文件路径在轨道中创建音频剪辑
- 设置轨道属性（静音、颜色、名称、臂、独奏等）
- 将 MIDI 剪辑复制到指定轨道
🎼 剪辑操作
- 在钢琴卷帘视图中获取剪辑
- 获取和管理剪辑中的所有笔记
- 在剪辑中添加、删除和替换注释
- 设置剪辑属性（名称、颜色、循环、循环开始、循环结束等）
🎧 音频操作
🔌设备管理
- 加载音频效果、乐器和插件
- 修改设备参数
- 浏览库中的可用设备
📝 状态管理
- 操作历史跟踪和详细日志记录
- 为关键操作创建快照
- 支持操作回滚（特别是笔记操作）
- 浏览并恢复之前的状态
📝 待办事项清单
- 允许在创建 midi 剪辑时返回创建的 clip_id（等待 ableton-js 更新）
- 支持自动包络调整
- 支持更多快照类型（轨道属性、设备参数等）
⚠️ 警告
- AI 直接操作 MIDI 片段可能会导致原始音符丢失，且无法通过 Ctrl + Z 撤销。请谨慎操作。如有需要，您可以请求 AI 协助您回滚音符操作。
📥 安装
先决条件
- Node.js环境：确保已安装 Node.js（建议使用 v20+）并且
npx命令可用🔗 下载： Node.js 官网
安装步骤
1. 安装 AbletonJS MIDI 远程脚本
选择以下三种方法之一来安装 MIDI 远程脚本：
- 方法一：一行安装（推荐）
npx @xiaolaa2/ableton-copilot-mcp --install-scripts
# or use the short form
npx @xiaolaa2/ableton-copilot-mcp -is
- 方法二：工具辅助安装
- 首先，启动 ableton-copilot-mcp（请参阅下面的使用部分）
- 让AI助手或者手动调用MCP工具
init_ableton_js自动完成安装
- 方法3：手动安装
- 在 Ableton 用户库中创建一个名为“Remote Scripts”的文件夹：
- Windows：
C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts - Mac：
/Users/[username]/Music/Ableton/User Library\Remote Scripts
- 从ableton-js项目下载 MIDI 远程脚本
- 将下载的
midi-script文件夹复制到上述位置 - 将其重命名为
AbletonJS
🔧 使用方法
快速入门
- 启动 Ableton Live
- 启用 AbletonJS 控制界面
- 打开 Ableton Live 偏好设置：
Preferences → Link/MIDI - 在
MIDI选项卡中，找到Control Surface部分 - 从下拉菜单中选择
AbletonJS
- 使用 MCP 客户端连接以下客户端可用作 MCP 端点：
客户端配置
游标配置示例
将以下配置添加到您的 Cursor 设置中：
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp"
]
}
对于最新版本：
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp@latest"
]
}
自定义存储路径（可选）
您可以使用BASE_PATH环境变量指定自定义数据存储位置：
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp"
],
"env": {
"BASE_PATH": "D:\\ableton_copilot_mcp"
}
}
💡提示：存储路径用于保存日志文件、操作历史记录和状态快照
使用技巧
- 首次连接时，可能需要几秒钟才能与 Ableton Live 建立通信
- 确保 Ableton Live 正在运行并且 AbletonJS 控制界面已正确加载
- 要检查连接状态，您可以使用 MCP 工具中的
get_song_status命令
✅ 兼容性测试
兼容性主要取决于ableton-js库的版本支持。
| Ableton Live 版本 | 测试状态 |
|---|
| 12.1.10 | ✅ 已测试并正常运行 |
| 11.x | ⚠️ 尚未测试 |
| 10.x | ⚠️ 尚未测试 |
🤝 贡献
欢迎提出问题并做出贡献。请通过GitHub Issues提交问题或建议。
📄 许可证
该项目已获得MIT 许可。
⚠️ 免责声明
这是第三方集成，不是由 Ableton 制作的。