Ableton Copilot MCP

🚀 能力登-copilot-mcp

基於 ableton-js 的 MCP（模型上下文協議）服務器，用於即時交互和控制 Ableton Live，協助音樂製作人完成音樂創作。

🚀 快速開始

本項目是基於 ableton-js 的 MCP 服務器，能實現與 Ableton Live 的即時交互和控制，助力音樂創作。使用前請確保完成安裝步驟，並按照使用方法進行操作。

✨ 主要特性

🎵 歌曲控制

• 獲取歌曲基本信息（根音、音階名稱、節拍、歌曲長度等）
• 獲取所有軌道的列表
• 創建 MIDI、音頻和返回軌道
• 刪除和複製軌道

🎹 軌道管理

• 獲取軌道中的所有片段
• 創建空的 MIDI 片段
• 設置軌道屬性（靜音、顏色、名稱、啟用錄音、獨奏等）
• 將 MIDI 片段複製到指定軌道

🎼 片段操作

• 在鋼琴卷視圖中獲取片段
• 獲取並管理片段中的所有音符
• 添加、刪除和替換片段中的音符
• 設置片段屬性（名稱、顏色、循環、loop_start、loop_end 等）

🎧 音頻操作

• 支持基於時間範圍錄製軌道內容

📦 安裝指南

1. 安裝 Node.js：確保 npx 命令可用。建議從 Node.js 官方網站 安裝最新穩定版本。
2. 安裝 MIDI 遠程腳本：按照 ableton-js 項目中的說明安裝 AbletonJS MIDI 遠程腳本到您的 Ableton Live 中。

💻 使用示例

基礎用法

環境準備

1. 確保 Ableton Live 已啟動並運行。

2. 確保啟用 AbletonJS 控制面板：

   路徑：設置 -> 鏈接、節拍和 MIDI -> MIDI -> 控制面板

   圖 1：在 Ableton Live 中啟用 AbletonJS 控制面板

客戶端連接

使用 MCP 客戶端連接，包括但不限於：

• Cursor
• Cherry Studio
• Claude Desktop

Cursor 配置示例

在 Cursor 中配置 ableton-copilot-mcp：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "ableton-copilot-mcp"
    ]
}

📚 詳細文檔

兼容性測試

兼容性主要取決於 ableton-js 庫支持的版本。

貢獻

歡迎貢獻！請參考 貢獻指南。

開發

要開發，請克隆倉庫並運行：

npm install

然後在主文件中進行修改：

node index.js

📄 許可證

本項目受 MIT 許可證保護。