🚀 设置指南

本指南将详细介绍如何安装和配置相关依赖，以及如何运行和使用 ableton-vibe 服务器。

📦 安装依赖项

在开始使用 ableton-vibe 之前，需要安装一些必要的依赖项。

1. 安装 yarn，因为 ableton-js 使用它来运行一些构建脚本：

npm install --global yarn

2. 安装 pnpm：

brew install pnpm

⚙️ 克隆和运行 ableton-vibe 服务器

完成依赖项安装后，需要克隆并运行 ableton-vibe 服务器。

1. 克隆并安装 midi-script 到 Ableton：

git clone https://github.com/leolabs/ableton-js.git && cd ableton-js && yarn ableton11:start

2. 如果尚未克隆，克隆 ableton-vibe 服务器：

git clone https://github.com/androidStern/ableton-vibe.git && cd ableton-vibe && pnpm i

🔨 构建和监听更改

克隆并安装完成后，需要构建项目并监听更改：

npm run build

⚙️ 配置 MCP 到 Claude

在你的机器上，Claude 的配置文件通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json。将以下内容添加到该文件中：

{
  "mcpServers": {
    "ableton-vibe": {
      "command": "node",
      "args": ["<path-to-repo>/ableton-vibe/ableton-mcp.js"]
    }
  }
}

其中，<path-to-repo> 是你克隆 ableton-vibe 的路径。

💻 使用方法

完成上述配置后，就可以使用 ableton-vibe 服务器了。

1. 确保 Ableton 正在运行。
2. 在使用服务器之前，重新启动 Claude。
3. 尝试询问 Claude：“创建索引 0 处的 MIDI 轨道”。目前它只能执行这个操作。

📋 兼容性说明

支持的 Ableton 版本

• 已测试与 Ableton 11 兼容，尚未尝试过 Ableton 12。

支持的操作系统

• 只在 macOS 上进行了测试。
• 对于 Windows，可能需要修改 ablton-mcp.ts 第 9 行以获取临时目录逻辑。相关代码如下：

const userTempDir = execSync('getconf DARWIN_USER_TEMP_DIR').toString().trim()

🐞 调试

运行 MCP 检查工具以快速调试服务器：

npm run inspect

然后在输出中打开 URL。有关检查器的使用说明，请参阅 这里。

🧪 测试添加设备脚本

test-browser.js 是一个示例脚本，用于将设备程序化地添加到你的 Ableton 会话中。运行时需要确保：

• Ableton 正在运行。
• 已安装并运行了 ableton-js 的 MIDI 远控脚本。

运行命令：

node test-browser.js

🤝 贡献指南

目前所有代码都在 ablton-mcp.ts 中。如果你要添加工具或资源，请将其添加到该文件中。请不要编辑 _JS_ 文件，而是编辑对应的 _TS_ 文件。

🚧 下一步计划

• 设置正确的构建和发布流程，未来应该可以通过一条命令完成所有安装。
• 完成剩余的 Ableton API 实现，使其通过 MCP 工具自动暴露。
• 支持 Ableton 12。
• 添加测试用例。
• 支持其他操作系统（Windows）。
• 增加语音控制功能。