项目简介
-
-
双向通信:通过基于套接字的服务器将 Claude AI 连接到 Ableton Live -
轨道操作:创建、修改和操作 MIDI 和音频轨道 -
乐器和效果选择:Claude 可以访问和加载 Ableton 库中的正确乐器、效果和声音 -
音频剪辑创建:创建和编辑带有音符的 MIDI 剪辑 -
会话控制:开始和停止播放,触发剪辑和控制传输
组件
该系统由两个主要组件组成:
-
Ableton Remote Script( Ableton_Remote_Script/__init__.py
):为 Ableton Live 创建的 MIDI 远程脚本,用于接收并执行命令的套接字服务器 -
MCP 服务器( server.py
):一个实现模型上下文协议并连接到 Ableton 远程脚本的 Python 服务器
安装
前置条件
-
Ableton Live 10 或更高版本 -
Python 3.8 或更高版本 -
uv 包管理器
如果您使用 Mac,请按照以下方式安装 uv:
brew install uv
否则,请从[uv 官方网站](https://docs.astral.sh/uv/getting-started/installation/)安装
桌面集成用的 Claude
按照设置说明视频操作
-
转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json,包含以下内容:
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"ableton-mcp"
]
}
}
}
Cursor集成
通过 uvx 不永久安装,运行 ableton-mcp。转到光标设置 > MCP,粘贴以下命令:
uvx ableton-mcp
⚠️ 只运行一个 MCP 服务器实例(Cursor 或 Claude 桌面之一),不要同时运行两个
安装 Ableton Remote Script
按照设置说明视频进行操作
-
从本仓库下载
AbletonMCP_Remote_Script/__init__.py
文件 -
将文件夹复制到 Ableton 的 MIDI Remote Scripts 目录。不同的操作系统和版本有不同的位置。以下是一些可能的工作路径,您可能需要查找:
对于 macOS:
对于 Windows:
-
方法 1: C:\Users[用户名]\AppData\Roaming\Ableton\Live x.x.x\首选项\用户远程脚本 -
方法 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) -
方法 1:转到应用程序 > 右键单击 Ableton Live 应用程序 → 显示包内容 → 导航到: Contents/App-Resources/MIDI Remote Scripts/
-
方法 2:如果第一种方法中没有,请使用直接路径(将 XX 替换为您的版本号): /Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts
-
在远程脚本目录下创建一个名为 ‘AbletonMCP’ 的文件夹,并将下载的 ‘__init__.py’ 文件粘贴进去
-
启动 Ableton Live
-
前往设置/首选项 → 链接、速度和 MIDI
-
在控制表面下拉菜单中选择 “AbletonMCP”
-
设置输入和输出为“无”
项目链接
扫码加入技术交流群,备注「开发语言-城市-昵称」
(文:GitHubStore)