Ableton Copilot MCP

🚀 能力登-copilot-mcp

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

🚀 快速开始

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

1. 安装 Node.js：确保 npx 命令可用。建议从 Node.js 官方网站 安装最新稳定版本。

2. 安装 MIDI 远程脚本：按照 ableton-js 项目中的说明安装 AbletonJS MIDI 远程脚本到您的 Ableton Live 中。

3. 确保 Ableton Live 已启动并运行。

4. 确保启用 AbletonJS 控制面板：

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

   图 1：在 Ableton Live 中启用 AbletonJS 控制面板

5. 使用 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 等）

🎧 音频操作

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

📦 安装指南

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

💻 使用示例

基础用法

在 Cursor 中配置 ableton-copilot-mcp：

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

📚 详细文档

兼容性测试

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

贡献

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

开发

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

npm install

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

node index.js

📄 许可证

本项目受 MIT 许可证保护。