ableton-copilot-mcp

基于ableton-js构建的 MCP（模型上下文协议）服务器，用于与 Ableton Live 进行实时交互和控制，致力于协助音乐制作人进行音乐制作。

🎯 注意

作为一名音乐制作人，我对使用 Ableton 进行音乐创作有一定的了解。在创作过程中，我们经常需要处理各种繁琐的操作，例如人性化音符属性、合并音符、将一个音轨录制到另一个音轨等等。以前，我们只能依赖宿主 DAW 提供的功能来完成这些操作。然而，随着大型语言模型和 MCP 的出现，我们拥有了让 AI 辅助自动化的可能性。虽然 AI 直接生成音符或创作一首完整的歌曲（它无法生成一首好听的歌曲）仍然不太现实，但让 AI 辅助我们进行一些辅助操作，代表了一种新的可能性。

Related MCP server: MCP Toolkit

🚀 功能

🎵 歌曲控制

• 获取歌曲的基本信息（根音、音阶名称、节奏、歌曲长度等）

• 获取所有曲目的列表

• 创建 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

• 方法二：工具辅助安装

  1. 首先，启动 ableton-copilot-mcp（请参阅下面的使用部分）

  2. 让AI助手或者手动调用MCP工具init_ableton_js自动完成安装

• 方法3：手动安装

  1. 在 Ableton 用户库中创建一个名为“Remote Scripts”的文件夹：

     • Windows： C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts

     • Mac： /Users/[username]/Music/Ableton/User Library\Remote Scripts

  2. 从ableton-js项目下载 MIDI 远程脚本

  3. 将下载的midi-script文件夹复制到上述位置

  4. 将其重命名为AbletonJS

🔧 使用方法

快速入门

1. 启动 Ableton Live

2. 启用 AbletonJS 控制界面

   • 打开 Ableton Live 偏好设置： Preferences → Link/MIDI

   • 在MIDI选项卡中，找到Control Surface部分

   • 从下拉菜单中选择AbletonJS

3. 使用 MCP 客户端连接

   以下客户端可用作 MCP 端点：

   • 光标

   • 樱桃工作室

   • 克劳德桌面

   • 其他 MCP 客户端

客户端配置

游标配置示例

将以下配置添加到您的 Cursor 设置中：

对于最新版本：

自定义存储路径（可选）

您可以使用BASE_PATH环境变量指定自定义数据存储位置：

💡提示：存储路径用于保存日志文件、操作历史记录和状态快照

使用技巧

• 首次连接时，可能需要几秒钟才能与 Ableton Live 建立通信

• 确保 Ableton Live 正在运行并且 AbletonJS 控制界面已正确加载

• 要检查连接状态，您可以使用 MCP 工具中的get_song_status命令

✅ 兼容性测试

兼容性主要取决于ableton-js库的版本支持。

🤝 贡献

欢迎提出问题并做出贡献。请通过GitHub Issues提交问题或建议。

📄 许可证

该项目已获得MIT 许可。

⚠️ 免责声明

这是第三方集成，不是由 Ableton 制作的。