AbletonMCP-Ableton实时模型上下文协议集成
AbletonMCP通过模型上下文协议(MCP)将Ableton Live连接到Claude AI,使Claude能够直接与Ableton Lives交互并控制Ableton。这种集成实现了快速辅助音乐制作、曲目创建和现场会话操作。
加入社区
提供反馈,获得灵感,并在MCP的基础上进行构建: Discord 的中文翻译是“不和谐”或“纷争”。.制造者 西达尔特
特性
- 双向通信:通过基于套接字的服务器将Claude AI连接到Ableton Live
- 轨迹操纵:创建、修改和操纵MIDI和音轨
- 仪器和效果选择:Claude可以从Ableton的库中访问和加载正确的乐器、效果和声音
- 剪辑创建:创建和编辑带有音符的MIDI片段
- 会话控制:启动和停止播放、播放剪辑和控制传输
组件
该系统由两个主要部分组成:
- Ableton远程脚本 (
Ableton_Remote_Script/__init__.py):Ableton Live的MIDI远程脚本,用于创建套接字服务器以接收和执行命令 - MCP服务器 (
server.py):实现模型上下文协议并连接到Ableton远程脚本的Python服务器
安装
通过Smithery安装
通过以下方式自动安装Ableton Live Integration for Claude Desktop 史密瑟里:
BASH``` 1npx -y @smithery/cli install @ahujasid/ableton-mcp —client claude
### 先决条件
- Ableton Live 10或更新版本
- Python 3.8或更高版本
- [uv包管理器](https://astral.sh/uv)
如果您使用的是Mac,请按以下方式安装uv:
1brew install uv
否则,请从[uv官方网站]安装[[https://docs.astral.sh/uv/getting-started/installation/\](https://docs.astral.sh/uv/getting-started/installation/%5C)]
⚠️ 安装UV之前不要继续
### Claude桌面集成
[按照设置说明视频进行操作](https://youtu.be/iJWJqyVuPS8)
1. 转到Claude>设置>开发人员>编辑配置>Claude_desktop_Config.json,以包含以下内容:
JSON```
1
2
3
4
5
6
7
8
9
10{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"ableton-mcp"
]
}
}
}
光标集成
运行ableton mcp,而无需通过uvx永久安装。转到光标设置>MCP并将其粘贴为命令:
1uvx ableton-mcp
⚠️ 只运行一个MCP服务器实例(在Cursor或Claude Desktop上),而不是两者都运行
安装Ableton远程脚本
- 下载
AbletonMCP_Remote_Script/__init__.py此仓库中的文件 - 将文件夹复制到Ableton的MIDI远程脚本目录。不同的操作系统和版本有不同的位置。 其中一个应该有效,你可能需要看看:
对于macOS:
- 方法1:转到应用程序>右键单击Ableton Live应用程序→ 显示包装内容→ 导航到:
Contents/App-Resources/MIDI Remote Scripts/ - 方法2:如果第一种方法中没有,请使用直接路径(将XX替换为您的版本号):
/Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts
对于Windows:
- 方法1: C: \用户[用户名]\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)
- 在远程脚本目录中创建一个名为“AbletonMCP”的文件夹,并粘贴下载的“init.py”文件
- 启动Ableton Live
- 转到设置/首选项→ 链接、节奏和MIDI
- 在控制界面下拉菜单中,选择“AbletonMCP”
- 将输入和输出设置为“无”
用法
启动连接
- 确保Ableton远程脚本已加载到Ableton Live中
- 确保MCP服务器已在Claude Desktop或Cursor中配置
- 当您与Claude交互时,应自动建立连接
与克劳德一起使用
一旦在Claude上设置了配置文件,并且远程脚本在Ableton中运行,您将看到一个带有Ableton MCP工具的锤子图标。
能力
- 获取会话和跟踪信息
- 创建和修改MIDI和音轨
- 创建、编辑和触发剪辑
- 控制播放
- 从Ableton的浏览器加载乐器和效果
- 为MIDI片段添加注释
- 更改节奏和其他会话参数
示例命令
以下是一些你可以要求克劳德做的事情的例子:
- “创作一首80年代的合成波曲目” 演示
- “创造Metro Boomin风格的嘻哈节拍”
- “使用合成低音乐器创建新的MIDI曲目”
- “为我的鼓添加混响”
- “用简单的旋律创建一个4小节MIDI片段”
- “获取有关当前Ableton会话的信息”
- “将808鼓架装入所选轨道”
- “在曲目1中的剪辑中添加爵士和弦级数”
- “将节奏设置为120 BPM”
- “播放曲目2中的剪辑”
故障排除
- 连接问题:确保加载了Ableton远程脚本,并且在Claude上配置了MCP服务器
- 超时错误:尝试简化您的请求或将其分解为更小的步骤
- 你试过把它关掉再打开吗?:如果您仍然存在连接错误,请尝试重新启动Claude和Ableton Live
技术细节
通信协议
该系统在TCP套接字上使用简单的基于JSON的协议:
- 命令以JSON对象的形式发送,并带有
type可选params - 响应是JSON对象,具有
status和result或message
限制和安全考虑
- 创建复杂的音乐编排可能需要分解成更小的步骤
- 该工具旨在与Ableton的默认设备和浏览器项目配合使用
- 在进行大量实验之前,始终保存您的工作
贡献
欢迎投稿!请随时提交拉取请求。
免责声明
这是第三方集成,不是由Ableton制作的。