Ableton Copilot MCP

Ableton Copilot MCP

Ableton Live とのリアルタイムのインタラクションとコントロールのためにableton-js上に構築された MCP (Model Context Protocol) サーバー。音楽プロデューサーの音楽制作を支援することに専念しています。

🎯 注記

音楽プロデューサーとして、私はAbletonを使った音楽制作についてある程度の知識を持っています。創作活動においては、音符のプロパティを人間化したり、音符を結合したり、あるトラックを別のオーディオトラックに録音したりするなど、様々な面倒な操作が必要になることがよくあります。以前は、これらの操作はホストDAWが提供する機能に頼るしかありませんでした。しかし、大規模言語モデルとMCPの登場により、AIに自動化を任せることができるようになりました。AIが直接音符を生成したり、完成した曲を作ったりするのはまだ現実的ではありません（良い音質の曲を作ることはできませんが）が、補助的な操作をAIに任せることで、新たな可能性が生まれます。

🚀 機能

🎵 曲のコントロール

• 曲の基本情報（ルート音、音階名、テンポ、曲の長さなど）を取得します。
• すべてのトラックのリストを取得する
• MIDI、オーディオ、リターントラックを作成する
• トラックの削除と複製

🎹 トラック管理

• トラック内のすべてのクリップを取得する
• アレンジメントビュートラックに空のMIDIクリップを作成する
• 提供されたサンプルファイルパスに基づいてトラックにオーディオクリップを作成します
• トラックのプロパティ（ミュート、色、名前、アーム、ソロなど）を設定します
• MIDIクリップを指定したトラックに複製する

🎼 クリップ操作

• ピアノロールビューでクリップを取得する
• クリップ内のすべてのメモを取得して管理する
• クリップ内のメモを追加、削除、置換する
• クリップのプロパティ（名前、色、ループ、loop_start、loop_end など）を設定します

🎧 オーディオ操作

• 時間範囲に基づいてトラックコンテンツを録音することをサポート

🔌 デバイス管理

• オーディオエフェクト、楽器、プラグインをロードする
• デバイスパラメータを変更する
• ライブラリ内の利用可能なデバイスを参照する

📝 状態管理

• 操作履歴の追跡と詳細なログ記録
• 重要な操作のためのスナップショットの作成
• 操作のロールバックのサポート（特にノート操作）
• 以前の状態を参照して復元する

📝 ToDoリスト

• MIDI クリップを作成するときに、作成された clip_id を返すことを許可します (ableton-js の更新を待機中)
• 自動エンベロープ調整をサポート
• より多くのスナップショット タイプ (トラック プロパティ、デバイス パラメーターなど) をサポートします

⚠️ 警告

• AIによるMIDIクリップの直接操作は、元のノートが失われる可能性があり、Ctrl + Zでも元に戻せません。慎重に操作してください。必要に応じて、AIにノート操作のロールバックを依頼できます。

📥 インストール

前提条件

• Node.js環境: Node.jsがインストールされ（v20以上を推奨）、 npxコマンドが利用可能であることを確認します。

  🔗 ダウンロード: Node.js 公式サイト

インストール手順

1. AbletonJS MIDIリモートスクリプトをインストールする

MIDI リモート スクリプトをインストールするには、次の 3 つの方法のいずれかを選択します。

• 方法 1: 1 行インストール (推奨)
  npx @xiaolaa2/ableton-copilot-mcp --install-scripts # or use the short form npx @xiaolaa2/ableton-copilot-mcp -is
• 方法2: ツールを使ったインストール
  1. まず、ableton-copilot-mcpを起動します（以下の使用方法のセクションを参照）。
  2. AIアシスタントまたは手動でMCPツールinit_ableton_js呼び出して、インストールを自動的に完了します。
• 方法3: 手動インストール
  1. Ableton ユーザー ライブラリに「Remote Scripts」という名前のフォルダーを作成します。
     • Windows: C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts
     • Mac: /Users/[username]/Music/Ableton/User Library\Remote Scripts
  2. ableton-jsプロジェクトからMIDIリモートスクリプトをダウンロードする
  3. ダウンロードしたmidi-scriptフォルダを上記の場所にコピーします
  4. 名前をAbletonJSに変更します

🔧 使用方法

クイックスタート

1. Ableton Liveを起動する
2. AbletonJSコントロールサーフェスを有効にする
   • Ableton Liveの環境設定を開く: Preferences → Link/MIDI
   • MIDIタブで、 Control Surfaceセクションを見つけます
   • ドロップダウンメニューからAbletonJSを選択します
3. MCPクライアントを使用して接続する次のクライアントを MCP エンドポイントとして使用できます。
   • カーソル
   • チェリースタジオ
   • クロードデスクトップ
   • その他のMCPクライアント

クライアント構成

カーソル設定例

カーソル設定に次の構成を追加します。

最新バージョンの場合:

カスタムストレージパス（オプション）

BASE_PATH環境変数を使用して、カスタム データの保存場所を指定できます。

💡ヒント: ストレージパスは、ログファイル、操作履歴、状態スナップショットを保存するために使用されます

使用上のヒント

• 初めて接続する場合、Ableton Liveとの通信を確立するのに数秒かかることがあります。
• Ableton Liveが実行中であり、AbletonJSコントロールサーフェスが適切にロードされていることを確認してください。
• 接続ステータスを確認するには、MCPツールのget_song_statusコマンドを使用します。

✅ 互換性テスト

互換性は主に、ableton-jsライブラリのバージョン サポートに依存します。

🤝 貢献する

問題のご報告や貢献を歓迎いたします。問題やご提案はGitHub Issuesからご提出ください。

📄 ライセンス

このプロジェクトはMIT ライセンスに基づいてライセンスされています。

⚠️免責事項

これはサードパーティの統合であり、Ableton によって作成されたものではありません。