ableton-mcp

环境要求

• 已安装 uv（必须，未安装前不要继续）
• Ableton Live 10.1.13 或更高版本
• MCP 客户端：Claude Desktop 或 Cursor（二选一）
• macOS 可用 brew 安装，Windows 参考 uv 官网安装方式

安装与启动步骤

1. 1安装 uv

   uv 是本项目运行 MCP 服务器和安装脚本的前置工具，官方警告未安装 uv 不要继续后续步骤。

   brew install uv

   复制

2. 2配置 MCP 客户端

   打开 Claude Desktop 的 Settings → Developer → Edit Config，写入右侧 JSON；Cursor 则在 Settings → MCP 中粘贴命令 uvx ableton-mcp。

   {
       "mcpServers": {
           "AbletonMCP": {
               "command": "uvx",
               "args": [
                   "ableton-mcp"
               ]
           }
       }
   }

   复制

3. 3安装 Remote Script

   把 Remote Script 复制到 Ableton User Library 的 Remote Scripts 文件夹；可先用 --list-targets 预览目标目录。

   uvx --from ableton-mcp ableton-mcp-install-script
   uvx --from ableton-mcp ableton-mcp-install-script --list-targets

   复制

4. 4指定自定义库路径

   若 User Library 不在默认位置且未被自动识别，用 --target 直接指向其 Remote Scripts 目录。

   uvx --from ableton-mcp ableton-mcp-install-script --target "/path/to/User Library/Remote Scripts"

   复制

5. 5在 Live 中启用

   重启 Ableton，进入 Settings/Preferences → Link, Tempo & MIDI，Control Surface 选择 AbletonMCP，Input 与 Output 都设为 None。

关键配置

如何确认成功

重启 Ableton 后，在 Link, Tempo & MIDI 的 Control Surface 中能看到并选中 AbletonMCP，即脚本加载成功。

常见问题

注意事项

• 必须先安装 uv，README 明确提示未安装前不要继续。
• 服务器启动时不会自动安装 Remote Script，写入 Ableton 配置目录需要手动执行安装命令。
• 安装脚本会备份已存在的脚本为 __init__.py.bak，再替换为新版本。
• 若 pip 或 pipx 安装过该包，可直接运行 ableton-mcp-install-script 命令。