Ableton Copilot MCP

🚀 能力登-copilot-mcp

ableton-js をベースにした MCP（モデルコンテキストプロトコル）サーバーで、Ableton Live のリアルタイムインタラクションと制御を行い、音楽制作を支援します。

🚀 クイックスタート

このサーバーは、音楽制作を支援するために、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 コントロールパネルを有効にする

3. 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 ライセンスの保護を受けています。

🤝 貢献

貢献を歓迎します！貢献ガイド を参照してください。