ableton-copilot-mcp

ableton-copilot-mcp

ableton-js を基盤とする MCP（Model Context Protocol）サーバーです。Ableton Live のアレンジメントビューをリアルタイムで操作・制御し、音楽制作を支援します。

🎯 備考

音楽プロデューサーとして、Ableton での楽曲制作についてある程度の知識があります。制作中には、ノートのプロパティのヒューマナイズ、ノートの結合、あるトラックから別のオーディオトラックへの録音など、さまざまな面倒な作業が必要になることがよくあります。これまでは、こうした作業にはホスト DAW が提供する機能に頼るしかありませんでした。しかし、LLM と MCP の登場により、AI に自動化を任せられる可能性が生まれました。AI がノートを直接生成したり、楽曲全体を作ったりするのはまだ現実的ではありません（良い曲を生成できません）が、AI に補助的な作業を手伝ってもらうことは、新たな可能性をもたらします。

🎥 デモ

MIDI 操作の簡単なデモ動画です。

https://github.com/user-attachments/assets/8d635c4c-a1f2-44be-93ae-062038d14c71

🚀 機能

🎵 曲の操作

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

🎹 トラック管理

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

🎼 クリップ操作

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

🎧 オーディオ操作

• 時間範囲を指定してトラックの内容を録音

🔌 デバイス管理

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

📝 状態管理

• 操作履歴の追跡と詳細なログ記録
• 操作のロールバックに対応（現在はノート操作のみ）
• 過去の状態を参照、復元

📝 TODO リスト

• エンベロープの自動調整に対応
• より多くのスナップショットタイプに対応（トラックのプロパティ、デバイスのパラメーターなど）

⚠️ 警告

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

📥 インストール

前提条件

• Node.js 環境：Node.js がインストールされていることを確認してください（v20 以降を推奨）。また、npx コマンドが利用可能である必要があります。

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

インストール手順

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

以下の3つの方法から1つを選んで、MIDI リモートスクリプトをインストールします。

• 方法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 を選択します。
   

   図1：Ableton Live の設定で AbletonJS コントロールサーフェスを有効にする

3. MCP クライアントを使って接続します

   以下のクライアントを MCP エンドポイントとして使用できます。

   • Cursor
   • Cherry Studio
   • Claude Desktop
   • その他の MCP クライアント

クライアントの設定

Cursor の設定例

以下の設定を Cursor の設定に追加します。

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

最新バージョンの場合：

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

カスタム保存パス（任意）

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

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "@xiaolaa2/ableton-copilot-mcp"
    ],
    "env": {
        "BASE_PATH": "D:\\ableton_copilot_mcp"
    }
}

💡 ヒント：保存パスは、ログファイル、操作履歴、状態のスナップショットの保存に使用されます。

✅ 互換性テスト

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

Ableton Live のバージョン	テスト状況
12.1.10	✅ テスト済み、動作確認済み
11.x	⚠️ 未テスト
10.x	⚠️ 未テスト

🤝 コントリビューション

Issue やコントリビューションを歓迎します。GitHub Issues から Issue や提案を送信してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

⚠️ 免責事項

これはサードパーティ製の連携機能であり、Ableton が開発したものではありません。