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

AbletonMCP通过模型上下文协议（MCP）将Ableton Live与Claude AI连接起来，使Claude能够直接与Ableton Live交互并控制它。这一集成支持提示辅助的音乐制作、音轨创建以及Live会话操作。

加入社区

提供反馈、获取灵感并在MCP基础上进行构建：Discord。由Siddharth创建。

功能

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

组件

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

Ableton远程脚本（Ableton_Remote_Script/__init__.py）：Ableton Live的MIDI远程脚本，用于创建接收和执行命令的套接字服务器
MCP服务器（server.py）：实现模型上下文协议的Python服务器，连接到Ableton远程脚本

安装

通过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 Desktop集成

观看设置说明视频

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

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

Cursor集成

无需通过uvx永久安装即可运行ableton-mcp。进入Cursor设置 > MCP，并将以下内容粘贴为命令：

uvx ableton-mcp

⚠️ 请勿同时在Cursor和Claude Desktop上运行MCP服务器实例，只能选择其中一个。

安装Ableton远程脚本

观看设置说明视频

从本仓库下载AbletonMCP_Remote_Script/__init__.py文件
将文件夹复制到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）
在远程脚本目录中创建一个名为“AbletonMCP”的文件夹，并将下载的__init__.py文件粘贴进去
启动Ableton Live
进入设置/首选项 → 链接、速度和MIDI
在控制表面下拉菜单中选择“AbletonMCP”
将输入和输出设置为“无”

使用

开始连接

确保Ableton远程脚本已加载到Ableton Live中
确保MCP服务器已在Claude Desktop或Cursor中配置
当您与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

技术细节

通信协议

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

命令作为带有type和可选params的JSON对象发送
响应作为带有status和result或message的JSON对象返回

限制与安全注意事项

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

贡献

欢迎贡献！请随时提交拉取请求。

免责声明

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