AbletonMCP

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 Integration：

先决条件

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

如果您使用的是 Mac，请将 uv 安装为：

否则，请从 [uv 官方网站][ https://docs.astral.sh/uv/getting-started/installation/ ] 安装

⚠️ 在安装 UV 之前请勿继续

Claude 用于桌面集成

按照安装说明视频进行操作

1. 转到 Claude > 设置 > 开发人员 > 编辑配置 > claude_desktop_config.json 以包含以下内容：

光标集成

通过 uvx 运行 ableton-mcp，无需永久安装。前往“光标设置”>“MCP”，然后粘贴以下命令：

⚠️ 仅运行 MCP 服务器的一个实例（在 Cursor 或 Claude Desktop 上），而不是同时运行两者

安装 Ableton Remote 脚本

按照安装说明视频进行操作

1. 从此 repo 下载AbletonMCP_Remote_Script/__init__.py文件
2. 将该文件夹复制到 Ableton 的 MIDI 远程脚本目录。不同的操作系统和版本有不同的位置。其中一个应该可以，你可能需要查看：对于 macOS：
   • 方法 1：前往“应用程序”> 右键单击 Ableton Live 应用程序 → 显示包内容 → 导航至： Contents/App-Resources/MIDI Remote Scripts/
   • 方法二：如果第一种方法中没有找到，请使用直接路径（将 XX 替换为您的版本号）： /Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts

   对于 Windows：

   • 方法 1：C:\Users[用户名]\AppData\Roaming\Ableton\Live xxx\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 Remote 脚本已加载到 Ableton Live 中
2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置
3. 当你与 Claude 互动时，连接应该会自动建立

与 Claude 一起使用

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

功能

• 获取会话和轨道信息
• 创建和修改 MIDI 和音轨
• 创建、编辑和触发剪辑
• 控制播放
• 从 Ableton 的浏览器加载乐器和效果
• 向 MIDI 片段添加注释
• 更改节奏和其他会话参数

示例命令

以下是您可以要求克劳德做的事情的一些示例：

• “创作 80 年代合成波音乐”演示
• “创造 Metro Boomin 风格的嘻哈节奏”
• “使用合成低音乐器创建新的 MIDI 音轨”
• “给我的鼓添加混响”
• “创建一个带有简单旋律的 4 小节 MIDI 片段”
• “获取有关当前 Ableton 会话的信息”
• “将 808 鼓架加载到选定的轨道中”
• “为轨道 1 中的剪辑添加爵士和弦进行”
• “将节奏设置为 120 BPM”
• “播放轨道 2 中的剪辑”

故障排除

• 连接问题：确保 Ableton Remote Script 已加载，并且 MCP 服务器已在 Claude 上配置
• 超时错误：尝试简化您的请求或将其分解为更小的步骤
• 您是否尝试过将其关闭并重新打开？ ：如果仍然遇到连接错误，请尝试重新启动 Claude 和 Ableton Live

技术细节

通信协议

该系统使用基于 JSON 的简单 TCP 套接字协议：

• 命令以 JSON 对象的形式发送，带有type和可选params
• 响应是带有status和result或message JSON 对象

限制和安全注意事项

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

免责声明

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