Ableton Vibe

🚀 設置指南

本指南將詳細介紹如何安裝和配置相關依賴，以及如何運行和使用 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）。
• 增加語音控制功能。