Ableton Copilot MCP

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

🎯 注記

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

Related MCP server: MCP Toolkit

🚀 機能

🎵 曲のコントロール

• 曲の基本情報（ルート音、音階名、テンポ、曲の長さなど）を取得します。

• すべてのトラックのリストを取得する

• 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 によって作成されたものではありません。