Ableton AI助手连接器
通过模型上下文协议(MCP)将 Ableton Live 与人工智能助手连接起来,实现对音乐制作任务的自然语言控制,例如轨道创建、MIDI 编辑、乐器加载和播放控制。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"AbletonMCP": {
"args": [
"server"
],
"command": "PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp"
}
}
}
该服务需要配置环境变量:host、port
服务介绍
AbletonMCP Enhanced - 用于Ableton Live的AI控制
此工具通过Model Context Protocol (MCP)将Ableton Live连接到像Claude和Cursor这样的AI助手,使您能够使用自然语言命令来控制Ableton Live。
这是Siddharth Ahuja原始AbletonMCP的一个增强版本,进行了重大改进以简化安装和使用过程。
使用该工具可以做什么
- 创建和操作MIDI和音频轨道
- 从Ableton库加载乐器、效果和声音
- 创建并编辑带有音符的MIDI片段
- 控制播放(开始、停止、触发片段)
- 调整设备参数(如EQ设置)
- 以及更多!
音乐制作人快速入门指南
选项1:通过Smithery安装(最简单)
如果您正在使用Claude Desktop,最简单的安装方法是通过Smithery:
bash
npx -y @smithery/cli install @itsuzef/ableton-mcp --client claude
这将自动在Claude Desktop中设置MCP服务器。您仍然需要安装Ableton远程脚本(请参阅下面的步骤4)。
选项2:手动安装
步骤1:安装Python(一次性设置)
如果您还没有安装Python:
步骤2:安装AbletonMCP(一次性设置)
打开终端(Mac)或命令提示符(Windows),然后运行以下命令:
bash
为AbletonMCP创建一个文件夹
python -m venv ableton-mcp-env
在Mac/Linux上:
source ableton-mcp-env/bin/activate
在Windows上:
ableton-mcp-envScriptsactivate
安装AbletonMCP
pip install git+https://github.com/itsuzef/ableton-mcp.git
步骤3:安装Ableton远程脚本(一次性设置)
保持相同的终端/命令提示符窗口打开:
bash
将远程脚本安装到Ableton
ableton-mcp install
如果自动安装不起作用,工具会告诉您手动放置文件的位置。
步骤4:设置Ableton Live(一次性设置)
- 启动Ableton Live
- 进入首选项 → Link, Tempo & MIDI
- 在控制界面下拉菜单中选择“AbletonMCP_Remote_Script”
- 将输入和输出设置为“无”
- 单击“确定”保存设置
步骤5:连接您的AI助手
对于Claude Desktop:
- 前往Claude → 设置 → 开发者 → 编辑配置
- 在
claude_desktop_config.json中添加以下内容:
json
{
"mcpServers": {
"AbletonMCP": {
"command": "PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp",
"args": [
"server"
]
}
}
}
将PATH_TO_YOUR_ENVIRONMENT替换为您创建环境的完整路径。例如:
- Mac:
/Users/yourusername/ableton-mcp-env - Windows:
C:Usersyourusernameableton-mcp-env
对于Cursor:
- 前往Cursor设置 → MCP
- 添加以下命令:
PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp server
按上述说明替换PATH_TO_YOUR_ENVIRONMENT。
对于其他AI工具:
任何支持MCP的AI工具都可以通过指向您环境中ableton-mcp server命令来进行连接。
步骤6:开始用AI创作音乐!
- 打开Ableton Live
- 打开您的AI助手(Claude, Cursor等)
- 开始让您的AI控制Ableton!
注意:如果您通过Smithery安装(选项1),您可以跳过手动安装的步骤1-3和5。您只需要安装Ableton远程脚本(步骤4),然后就可以开始了!
可尝试的示例命令
- “创建一个新的带有合成贝斯乐器的MIDI轨道”
- “给轨道1添加混响”
- “创建一个包含简单旋律的4小节MIDI片段”- "将鼓机架加载到轨道2"
- "在轨道1的片段中添加爵士和弦进行"
- "将速度设置为120 BPM"
- "播放轨道2中的片段"
- "对轨道1应用低切EQ预设"
故障排除
连接问题
- 确保Ableton Live正在运行,然后再使用AI命令
- 检查Ableton的MIDI偏好设置中是否启用了远程脚本
- 如果遇到连接问题,请重启Ableton和您的AI助手
常见错误
- "找不到命令":请确保您已通过
source ableton-mcp-env/bin/activate(Mac/Linux)或ableton-mcp-envScriptsactivate(Windows)激活了环境。 - "无法连接到Ableton":请确保Ableton正在运行并且远程脚本已启用。
- "未找到远程脚本":尝试再次运行
ableton-mcp install或按照手动安装说明操作。
获取帮助
如果您仍然遇到问题,请查看GitHub问题页面或创建一个新的问题,并提供关于您问题的详细信息。
高级用法
对于熟悉命令行工具的用户,AbletonMCP提供了额外的命令:
bash
显示版本信息
ableton-mcp version
显示可用的MCP功能
ableton-mcp info
使用自定义主机/端口启动服务器
ableton-mcp server --host 127.0.0.1 --port 8080
致谢
此项目基于Siddharth Ahuja的原始AbletonMCP。我在其基础上构建了一个增强版,增加了更多特性和改进。
许可证
该项目根据MIT许可证发布 - 详情请参阅LICENSE文件。
免责声明
这是一个第三方集成,不是由Ableton制作的。