ableton-copilot-mcp

一个基于 ableton-js 搭建的 MCP（Model Context Protocol）服务器，用于与 Ableton Live 进行实时交互和控制，致力于辅助音乐制作人进行音乐制作。

🚀 功能特性

🎵 歌曲控制（Song）

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

🎹 音轨管理（Track）

• 获取音轨中的所有片段
• 在轨道中创建空白 MIDI 片段
• 设置音轨属性（静音、颜色、名称等）
• 复制 MIDI 片段到指定音轨

🎼 片段操作（Clip）

• 获取钢琴卷帘视图中的片段
• 获取、添加、删除和替换片段中的音符
• 设置片段属性（名称、颜色等）

🎧 其它操作（Audio）

• 支持对轨道内容进行录制

📥 安装准备

1. 安装 Node.js：确保 npx 命令可以正常运行，建议前往 Node.js 官网 安装最新的稳定版本
2. 安装 MIDI Remote Scripts：按照 ableton-js 项目说明将 AbletonJS 的 MIDI Remote Scripts 安装到您的 Ableton Live 中

🔧 使用方法

1. 确保 Ableton Live 已经启动并运行

2. 确保在配置中启用 AbletonJS 控制界面：

   路径：Settings -> Link, Tempo & MIDI -> MIDI -> Control Surface

3. 使用 MCP 客户端连接，支持的客户端包括但不限于：

   • Cursor
   • Cherry Studio
   • Claude Desktop

Cursor 配置示例

在 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 | ⚠️ 待测试 |

🤝 贡献

欢迎提交问题和贡献代码，请通过 GitHub Issues 提交问题或建议。

📄 许可证

本项目采用 MIT 许可证。