AbletonMCP - Ableton Live 模型上下文协议集成

AbletonMCP 通过模型上下文协议 (MCP) 将 Ableton Live 连接到 Claude AI，使 Claude 能够直接与 Ableton Live 交互并进行控制。这种集成实现了基于提示的音乐制作、音轨创建以及 Live 会话操作。

加入社区

提供反馈、获取灵感，并在 MCP 的基础上进行开发：Discord。由 Siddharth 制作。

功能

• 双向通信：通过基于套接字的服务器将 Claude AI 连接到 Ableton Live
• 音轨操作：创建、修改和操作 MIDI 及音频音轨
• 乐器与效果选择：Claude 可以访问并加载 Ableton 库中的合适乐器、效果和音色
• 片段创建：创建和编辑包含音符的 MIDI 片段
• 会话控制：开始和停止播放、触发片段以及控制走带功能

组件

该系统由两个主要组件组成：

1. Ableton 遥控脚本（Ableton_Remote_Script/__init__.py）：一个用于 Ableton Live 的 MIDI 遥控脚本，用于创建套接字服务器以接收和执行命令。
2. MCP 服务器（server.py）：一个实现模型上下文协议并与 Ableton 遥控脚本连接的 Python 服务器。

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Claude Desktop 的 Ableton Live 集成：

npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude

先决条件

• Ableton Live 10 或更高版本
• Python 3.8 或更高版本
• uv 包管理器

如果您使用的是 Mac，请按以下方式安装 uv：

brew install uv

否则，请从 uv 官方网站 安装。

⚠️ 请务必先安装 UV 再继续。

Claude for Desktop 集成

按照设置说明视频操作

1. 前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

Cursor 集成

通过 uvx 运行 ableton-mcp，而无需永久安装。前往 Cursor 设置 > MCP，并将以下命令粘贴进去：

uvx ableton-mcp

⚠️ 请仅运行 MCP 服务器的一个实例（无论是 Cursor 还是 Claude Desktop），不要同时运行两者。

安装 Ableton 遥控脚本

按照设置说明视频操作

1. 从本仓库下载 AbletonMCP_Remote_Script/__init__.py 文件。

2. 将该文件夹复制到 Ableton 的 MIDI 遥控脚本目录中。不同操作系统和版本的路径可能有所不同。以下路径中应该有一个有效，您可能需要查找一下：

   对于 macOS：

   • 方法 1：前往“应用程序”→右键点击 Ableton Live 应用程序 → 显示包内容 → 导航至： Contents/App-Resources/MIDI Remote Scripts/
   • 方法 2：如果第一种方法找不到，可以使用直接路径（将 XX 替换为您的版本号）： /Users/[用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts

   对于 Windows：

   • 方法 1： C:\Users[用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
   • 方法 2： C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\
   • 方法 3： C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\ 注：将 XX 替换为您的 Ableton 版本号（例如 10、11、12）

3. 在遥控脚本目录中创建一个名为“AbletonMCP”的文件夹，并将下载的 __init__.py 文件粘贴进去。

4. 启动 Ableton Live。

5. 前往设置/偏好设置 → 链接、速度与 MIDI。

6. 在“控制表面”下拉菜单中选择“AbletonMCP”。

7. 将输入和输出设置为“无”。

使用

启动连接

1. 确保 Ableton Live 中已加载 Ableton 遥控脚本。
2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置好。
3. 当您与 Claude 交互时，连接应自动建立。

与 Claude 配合使用

一旦在 Claude 上设置了配置文件，并且遥控脚本在 Ableton 中运行，您将看到一个带有 Ableton MCP 工具的锤子图标。

功能

• 获取会话和音轨信息
• 创建和修改 MIDI 和音频音轨
• 创建、编辑和触发片段
• 控制播放
• 从 Ableton 浏览器加载乐器和效果
• 向 MIDI 片段添加音符
• 更改速度和其他会话参数

示例命令

以下是一些您可以要求 Claude 执行的例子：

• “创建一首 80 年代合成器浪潮风格的曲目” 演示
• “创建一段 Metro Boomin 风格的嘻哈节拍”
• “创建一条带有合成贝斯乐器的新 MIDI 音轨”
• “为我的鼓声添加混响”
• “创建一个包含简单旋律的 4 小节 MIDI 片段”
• “获取当前 Ableton 会话的信息”
• “将 808 鼓架加载到选定的音轨中”
• “在第 1 音轨的片段中加入爵士和弦进行”
• “将速度设置为 120 BPM”
• “播放第 2 音轨中的片段”

故障排除

• 连接问题：确保 Ableton 遥控脚本已加载，并且 MCP 服务器已在 Claude 中正确配置。
• 超时错误：尝试简化您的请求或将它们分解为更小的步骤。
• 重启过吗？：如果仍然存在连接问题，请尝试重新启动 Claude 和 Ableton Live。

技术细节

通信协议

系统使用基于 JSON 的简单协议，通过 TCP 套接字进行通信：

• 命令以 JSON 对象的形式发送，包含 type 和可选的 params。
• 响应也是 JSON 对象，包含 status 以及 result 或 message。

限制与安全考虑

• 创建复杂的音乐编排可能需要分解为更小的步骤。
• 该工具设计用于与 Ableton 的默认设备和浏览器项目配合使用。
• 在进行大量实验之前，请务必保存您的工作。

贡献

欢迎贡献！请随时提交 Pull Request。

免责声明

这是一个第三方集成，并非由 Ableton 开发。

AbletonMCP 快速上手指南

AbletonMCP 通过模型上下文协议（MCP）将 Ableton Live 与 Claude AI 连接，使 AI 能够直接控制音乐制作软件，实现提示词辅助创作、轨道管理及会话控制。

环境准备

在开始之前，请确保满足以下系统要求和依赖：

• 操作系统：macOS 或 Windows
• 软件版本：Ableton Live 10 或更高版本
• 运行环境：Python 3.8 或更高版本
• 包管理器：uv (必须安装)

安装 uv：

• macOS 用户：

  brew install uv
  

• Windows/Linux 用户： 请访问 uv 官方安装文档 进行安装。

⚠️ 注意：在未安装 uv 之前请勿继续后续步骤。

安装步骤

本工具由两部分组成：Ableton 远程脚本（运行在 Ableton 内）和 MCP 服务器（运行在 Claude/Cursor 中）。

第一步：配置 Ableton 远程脚本

1. 从项目仓库下载 Ableton_Remote_Script/__init__.py 文件。

2. 将该文件放入 Ableton Live 的 MIDI Remote Scripts 目录中。根据系统和版本不同，路径可能如下（请将 XX 替换为你的版本号，如 11, 12）：

   • macOS:
     • 方法 A：右键点击 Ableton Live 应用 → 显示包内容 → Contents/App-Resources/MIDI Remote Scripts/
     • 方法 B：/Users/[用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts
   • Windows:
     • C:\Users\[用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
     • 或 C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\

3. 在上述目录中新建文件夹 AbletonMCP，并将 __init__.py 文件粘贴进去。

4. 启动 Ableton Live。

5. 进入 Settings/Preferences → Link, Tempo & MIDI。

6. 在 Control Surface 下拉菜单中选择 AbletonMCP。

7. 将对应的 Input 和 Output 均设置为 None。

第二步：配置 MCP 服务器

根据你的使用场景，选择 Claude Desktop 或 Cursor 其中一种方式进行配置（⚠️ 请勿同时运行两个实例）。

选项 A：Claude Desktop 集成

1. 打开配置文件：claude_desktop_config.json

   • 路径通常在：Claude 应用菜单 > Settings > Developer > Edit Config

2. 在 mcpServers 字段中添加以下配置：

   {
       "mcpServers": {
           "AbletonMCP": {
               "command": "uvx",
               "args": [
                   "ableton-mcp"
               ]
           }
       }
   }
   

选项 B：Cursor 集成

1. 打开 Cursor 设置，找到 MCP 部分。
2. 添加新的 MCP 服务器，命令填写：

   uvx ableton-mcp
   

基本使用

完成上述配置后，即可开始使用 AI 控制 Ableton Live。

1. 启动服务：确保 Ableton Live 已加载 AbletonMCP 控制表面，且 Claude Desktop 或 Cursor 已重启以加载配置。
2. 建立连接：在聊天窗口中与 Claude 对话，连接会自动建立。成功连接后，输入框附近会出现一个锤子图标（工具标识）。
3. 发送指令：直接使用自然语言下达音乐制作指令。

使用示例：

• 创建特定风格的曲目：

  "Create an 80s synthwave track" （创建一个 80 年代合成器浪潮风格的曲目）

• 添加乐器与效果：

  "Create a new MIDI track with a synth bass instrument" （创建一个带有合成贝斯乐器的新 MIDI 轨道） "Add reverb to my drums" （给我的鼓组添加混响效果）

• 编辑片段与控制播放：

  "Create a 4-bar MIDI clip with a simple melody" （创建一个包含简单旋律的 4 小节 MIDI 片段） "Set the tempo to 120 BPM" （将速度设置为 120 BPM） "Play the clip in track 2" （播放第 2 轨的片段）

💡 提示：对于复杂的编曲任务，建议将需求拆分为多个小步骤依次发送给 AI，以获得更稳定的执行结果。操作前请记得保存你的工程文件。