使用说明
Rust MCP服务器，使AI助手能够通过OSC控制Ableton Live。
📖 文档
特性
- 266工具 用于全面的Ableton Live控制
- 实时OSC 通过 AbletonOSC
- 自动安装程序 AbletonOSC远程脚本
- 跨平台 （macOS、Windows、Linux）
快速开始
1.安装混音mcp
通过紫外线 （推荐，需要 紫外线):
uvx remix-mcp install
下载二进制文件 从 发布
从源代码构建：
git clone --recursive https://github.com/christopherwxyz/remix-mcp
cd remix-mcp
cargo build --release
2.安装AbletonOSC
remix-mcp install
然后在Ableton Live中：
- 重新启动Ableton Live
- 打开 偏好 （Cmd+、/Ctrl+、）
- 首选 链接/节奏/MIDI
- 在...之下 控制表面，选择 AbletonOSC
您应该看到： AbletonOSC: Listening for OSC on port 11000
3.添加MCP服务器
克劳德桌面：
- 打开克劳德桌面设置>开发人员
- 单击编辑配置打开
claude_desktop_config.json - 添加服务器配置：
{
"mcpServers": {
"ableton": {
"command": "uvx",
"args": ["remix-mcp"]
}
}
}
- 重新启动克劳德桌面
克劳德代码：
claude mcp add ableton -- uvx remix-mcp
用法
问克劳德这样的问题：
- “使用Drift创建MIDI曲目并添加混响”
- “将速度设置为128 BPM”
- “创建4杆鼓图案”
- “在所选曲目中添加琶音”
- “在浏览器中搜索低音”
请参阅 文档 更多示例。
工具
| 类别 | 计数 | 示例 |
|---|---|---|
| 运输 | 10 | play, stop, record, set_tempo |
| 曲目 | 59 | create_midi_track, set_track_volume, arm_track |
| 剪辑 | 65 | fire_clip, create_clip, add_midi_notes |
| 场景 | 19 | fire_scene, create_scene, duplicate_scene |
| 设备 | 10 | list_devices, set_device_parameter |
| 歌曲 | 56 | undo, redo, set_loop, get_quantization |
| 视图 | 8 | select_track, select_clip, select_device |
| 线索点数 | 5 | list_cue_points, jump_to_cue_point |
| 浏览器 | 29 | load_instrument, load_audio_effect, search_browser |
| 应用程序 | 4 | get_version, get_application_view |
| MIDI映射 | 1 | get_midi_map_addresses |
建筑
Claude/Client <--stdio/JSON-RPC--> remix-mcp <--UDP/OSC--> AbletonOSC <--> Ableton Live
命令行界面
remix-mcp serve # Start MCP server (default)
remix-mcp install # Install AbletonOSC Remote Script
remix-mcp install --force # Reinstall
remix-mcp status # Check installation
故障排除
MIDI曲目没有声音？
取样器需要装载样品。使用 load_default_instrument 加载Drift（一种立即工作的合成器）。
连接超时？
- 检查Ableton Live是否正在运行
- 验证是否在“首选项”>“链接/节奏/MDI”中启用了AbletonOSC
- 确保端口11000/11001空闲
AbletonOSC不在控制面列表中？
- 跑
remix-mcp install - 重新启动Ableton Live
发展
请参阅 贡献指南 发展指南。
许可证
麻省理工学院
致谢
- AbletonOSC 丹尼尔·琼斯