Ableton MCP Ultimate

Ableton MCP终极版

Ableton Live最全面的MCP服务器。352工具。99%的测试覆盖率。

通过Claude、Cursor或任何兼容MCP的AI客户端，通过自然语言控制Ableton Live的各个方面。从创建曲目和编写MIDI模式到调整更简单的样本、管理凹槽池和路由侧链——所有这些都是对话式的。

______________________________________________________________________

特性

______________________________________________________________________

建筑

┌─────────────────────┐     ┌──────────────────────┐     ┌──────────────────┐
│  Claude / Cursor /   │     │   MCP Server          │     │  Ableton Live    │
│  Any MCP Client      │◄───►│   (FastMCP, Python)   │◄───►│  Remote Script   │
│                      │ MCP │   352 @mcp.tool()      │ TCP │  (ControlSurface)│
│                      │     │   server.py (6069 ln)  │9877 │  __init__.py     │
└─────────────────────┘     └──────────────────────┘     │  (8834 lines)    │
                                                          └──────────────────┘

远程脚本作为ControlSurface在Ableton的Python运行时环境中运行。它打开一个TCP套接字 localhost:9877 并处理JSON命令。MCP服务器将工具调用转换为TCP消息并返回结果。

螺纹安全： 状态修改命令通过Ableton的 schedule_message() 在主线程上运行。只读命令直接在套接字线程上执行，以降低延迟。

______________________________________________________________________

快速开始

1.安装远程脚本

复制 AbletonMCP_Remote_Script Ableton的用户远程脚本目录中的文件夹：

macOS：

cp -r AbletonMCP_Remote_Script ~/Library/Preferences/Ableton/Live\ 12.*/User\ Remote\ Scripts/AbletonMCP

窗户：

Copy AbletonMCP_Remote_Script to:
%APPDATA%\Ableton\Live 12.x\Preferences\User Remote Scripts\AbletonMCP

2.在Ableton中启用

1. 打开Ableton直播
2. 首选 首选项>链接、节奏和MIDI
3. 在...之下 控制表面，选择 AbletonMCP 从下拉列表中
4. 您应该在日志中看到“AbletonMCP已初始化”

3.安装MCP服务器

cd ableton-mcp-ultimate
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

4.配置您的MCP客户端

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ableton-mcp-ultimate": {
      "command": "/path/to/ableton-mcp-ultimate/.venv/bin/ableton-mcp-ultimate"
    }
  }
}

克劳德代码（CLI）

claude mcp add ableton-mcp-ultimate /path/to/ableton-mcp-ultimate/.venv/bin/ableton-mcp-ultimate

光标

添加到光标MCP设置中：

{
  "mcpServers": {
    "ableton-mcp-ultimate": {
      "command": "/path/to/ableton-mcp-ultimate/.venv/bin/ableton-mcp-ultimate"
    }
  }
}

5.验证

问你的AI客户端：

“检查Ableton是否已连接”

它应该呼叫 health_check 以及返回速度、曲目计数和连接状态。

______________________________________________________________________

配置

用于调整连接行为的可选环境变量：

______________________________________________________________________

你能用它做什么

以对话方式创建完整曲目：

• “创建鼓轨道，加载808套件，以140 BPM的速度编写陷阱模式”
• “添加一个带有低音的低音曲目，用F小调写一个模式”
• “设置从踢腿到低音的侧链压缩”
• “在返回曲目上添加混响和延迟，将合成器路由到两者”
• “将鼓量化为1/16个音符，将速度人性化15%”
• “将hi-hats上的音符概率设置为50%以进行变化”
• 使用定位器创建包含引言、韵文、合唱部分的编排

混合和生产：

• “将踢腿音量设置为-3dB，将高帽稍微向右平移”
• “为人声添加EQ 8，降低到80Hz以下，提高到3kHz”
• “独奏低音曲目，检查输出音量”
• “将凹槽‘摆动16ths’分配给鼓夹并提交”

______________________________________________________________________

已知限制

Ableton Live 12的Python API中有一些工具遇到了重重困难。这些不是bug——它们会返回明确的错误消息，指导您使用Ableton的UI：

______________________________________________________________________

比较

______________________________________________________________________

项目结构

ableton-mcp-ultimate/
├── AbletonMCP_Remote_Script/
│   └── __init__.py          # Remote Script (8,834 lines) — runs inside Ableton
├── MCP_Server/
│   ├── __init__.py          # Package init
│   └── server.py            # MCP Server (6,069 lines) — 352 tools
├── research/                # Reference implementations studied during development
├── pyproject.toml           # Package configuration
├── CLAUDE.md                # Detailed tool documentation
├── IMPLEMENTATION_PLAN.md   # Development history
├── TEST_RESULTS.md          # Comprehensive test results
├── LICENSE                  # MIT License
└── README.md                # This file

______________________________________________________________________

需求

• Ableton Live 11或12 （在Live 12.3.5上测试）
• Python 3.10+ （适用于MCP服务器）
• mcp>=1.0.0 （模型上下文协议库）

______________________________________________________________________

贡献

欢迎投稿！一些需要帮助的领域：

• 测试 视窗 和 Linux
• 测试 Ableton Live 11 （目前测试于12.3.5）
• 为我们可能错过的功能添加工具
• 改进错误消息和文档
• TCP通信层的性能优化

请先打开一个问题来讨论重大更改。

______________________________________________________________________

许可证

MIT许可证。看 许可证 了解详情。

______________________________________________________________________

致谢