🚀 设置指南
本指南将详细介绍如何安装和配置相关依赖，以及如何运行和使用 ableton-vibe 服务器。
📦 安装依赖项
在开始使用 ableton-vibe 之前，需要安装一些必要的依赖项。
- 安装
yarn，因为ableton-js使用它来运行一些构建脚本：
npm install --global yarn
- 安装
pnpm：
brew install pnpm
⚙️ 克隆和运行 ableton-vibe 服务器
完成依赖项安装后，需要克隆并运行 ableton-vibe 服务器。
- 克隆并安装
midi-script到 Ableton：
git clone https://github.com/leolabs/ableton-js.git && cd ableton-js && yarn ableton11:start
- 如果尚未克隆，克隆
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": ["/ableton-vibe/ableton-mcp.js" ]
}
}
}
其中，
是你克隆 ableton-vibe 的路径。
💻 使用方法
完成上述配置后，就可以使用 ableton-vibe 服务器了。
- 确保 Ableton 正在运行。
- 在使用服务器之前，重新启动 Claude。
- 尝试询问 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）。
- 增加语音控制功能。