ableton-copilot-mcp

基于 ableton-js 的 MCP（Model Context Protocol）服务器，用于与 Ableton Live 实时交互和控制，专门帮助音乐制作人进行音乐创作。

🚀 功能

🎵 歌曲控制

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

🎹 轨道管理

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

🎼 片段操作

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

🎧 音频操作

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

📥 安装

1. 安装 Node.js：确保 npx 命令可用。建议从 Node.js 官方网站 下载并安装最新稳定版本
2. 安装 MIDI Remote Scripts：按照 ableton-js 项目的说明将 AbletonJS MIDI Remote Scripts 安装到你的 Ableton Live 中

🔧 使用方法

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

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

   路径: 设置 -> Link, Tempo & MIDI -> MIDI -> 控制界面

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

   • Cursor
   • Cherry Studio
   • Claude Desktop

Cursor 配置示例

在 Cursor 中配置 ableton-copilot-mcp：

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

✅ 兼容性测试

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

🤝 贡献

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

📄 许可证

该项目采用 MIT 许可证。