Ableton Live MCP Server

Ableton Live MCP サーバー

ウェブサイトとインストールガイド：abletonmcp.com

AI アシスタントから Ableton Live を操作できます。これは Model Context Protocol（MCP）サーバーで、Claude、Cursor、Codex、またはあらゆる MCP クライアントに 156 個のツールを提供します。起動中の Ableton Live セット内でトラックの作成、MIDI の編集、楽器やエフェクトの読み込み、ミキシング、マスタリングができます。また、Live を終了した状態で、保存済みの .als プロジェクトファイルを読み取り、差分を確認できるオフラインツールも備えています。

Remote Script が Live 内で動作し、ローカルソケット経由で Live API を公開します。MCP サーバーはこれを、AI が正しく呼び出せる、型付きで検証済みのツールに変換します。各ツールのドキュメント、読み取り専用および破壊的操作のヒント、ワークフロー用プロンプトも含まれています。

クイックスタート

Ableton Live 11 または 12、Python 3.10 以降、uv （brew install uv）が必要です。

1. MCP サーバーを登録します。

Codex（ローカルのデスクトップ、CLI、または IDE ホスト）：

codex mcp add ableton -- uvx [email protected]
codex mcp list

手動設定とトラブルシューティングについては、Codex ガイドを参照してください。

Claude Code：

claude mcp add AbletonMCP -s user -- uvx [email protected]

Claude Desktop または Cursor の場合は、設定ファイルの mcpServers ブロックに追加します。

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "uvx",
      "args": ["[email protected]"]
    }
  }
}

（未リリースのリビジョンを実行する場合は、代わりに uvx --from git+https://github.com/wstierhout/ableton-live-mcp ableton-live-mcpを使用してください。）

2. Remote Script をインストールします。 Live 側のスクリプトを User Library にコピーします。

uvx [email protected] install

次に、Live でブリッジを有効にします。

1. Ableton Live を完全に再起動します。
2. Settings > Tempo & MIDI を開き、MIDI セクションとその Control Surface リストを探します。
3. 使用していない Control Surface の行で AbletonMCP を選択します。既存のハードウェアコントローラーの行は変更しないでください。
4. 同じ行で Input: None と Output: None を設定します。

現在の Live バージョンでは、Link は独立した Settings ページにあります。古いバージョンでは、Settings/Preferences の Link, Tempo & MIDI（または Link/MIDI）を開き、MIDI セクションを探してください。

この選択はすべての MCP クライアントで必要です。インストールすると Remote Script がコピーされ、Control Surface を選択すると Live 内で起動します。ブリッジはローカルソケットを使用するため、この行にハードウェア MIDI の入力／出力ポートは必要ありません。

パッケージをアップグレードした後はインストーラーを再実行し、Live 側のスクリプトのバージョンを一致させてください。エントリが表示されない場合は、Ableton のサードパーティ製 Remote Script ガイドを参照してください。

3. セットアップを確認します。

uvx [email protected] doctor --json

ライブラリの場所を変更した場合は、インストール時と doctor の実行時に同じ --user-library "/path/to/User Library" を指定してください。古いスクリプトや別のスクリプトが存在する場合、インストールは停止します。--replace を追加する前に内容を確認してください。一意のバックアップが保持されます。診断を始める前に Live を再起動してください。doctor は、インストール済みのファイルと実行中のブリッジのバージョンの両方を確認します。

4. 読み取り専用で始めます。 変更を加えずに、テンポとトラック名を尋ねます。次に、使い捨てのセットで「80 BPM のローファイビートを、くぐもったドラムキット、アップライトベース、ローズのコードを使って作り、マスターに -1 dB のリミッターをかけて」と試してみてください。

できること

分野	ツール
セッションとトランスポート	セッション情報、1 回の呼び出しでのセッションスナップショット、再生／停止、テンポ、タップテンポ、拍子、ループ、ロケーターとキューの移動、シーン、取り消し／やり直し、MIDI キャプチャ、曲のスケール、グローバルグルーヴとスウィング、Ableton Link
トラックとミキサー	MIDI、オーディオ、リターントラックの作成と削除、デバイスの削除、テイクレーン、グループトラックの折りたたみ、音量、パン、ミュート、ソロ、アーム、センド、入力／出力ルーティング、メーター
クリップとノート	クリップの作成、MIDI ノートの書き込みと編集（確率指定を含む）、強さを指定したクオンタイズ、Groove Pool のスウィング、ループ、ゲイン、ピッチ、ワープモード
デバイス	名前による参照と検索、Master や Returns を含む任意のトラックへのインストゥルメントとエフェクトの読み込み、あらゆるパラメーターの読み取りと設定、サイドチェインルーティング、サンプルのプレビュー、ラックマクロのバリエーション、Simpler のサンプルスライス、パッドごとのドラム制御、厳選されたデバイスナレッジベース
アレンジメント	タイムラインへのクリップ配置、アレンジメントクリップの読み取りと削除、クリップオートメーションの書き込み
生成	7 種類のスタイルのドラムパターン、ユークリッドリズム、コード進行、声部進行を意識したジャズボイシング、ジャンルを考慮した 50 種類以上のコード進行、声部進行を意識したメロディー、ウォーキングベースライン、モチーフの変形（反転、逆行、拡大）、ミニマリスト的な手法、ヒューマナイズ、1 回の呼び出しでのセッション設定
一括処理	1 回のラウンドトリップと 1 回の取り消し操作で複数の編集を実行
オーディオと分析	エクスポートダイアログを使わずにセクションを WAV に録音、キーとスケールの検出、ミックスの問題のスキャン、前回の確認以降のセッション差分
オフライン（Live 不要）	要約、トラック一覧、MIDI の抽出、キーの検出、ミキサーとロケーターの詳細の読み取り、2 つのバージョンの差分、保存済み .als のリント、エディション検出を含む .adg／.adv ラックの解析
レシピ	ジャンル別のスターター（lofi、house）を 1 回の呼び出しで作成

さらに、5 つのワークフロープロンプト（make_a_beat、mix_and_master、 start_a_track、sound_design、analyze_and_improve）と、最初の呼び出しの前に モデルへ規則を教えるサーバー指示があります。 インデックスは 0 から始まり、時間は拍で指定し、音量 0.85 は 0 dB に相当し、 デバイスパラメーターにはネイティブ範囲を使用します。

注意事項

すべての操作は、引数が検証される個別のツールとして提供されます。任意のコードを 実行する方法はありません。一部のツールは破壊的な編集（トラックの削除、クリップの ノートの置換、アレンジメント領域の上書き）を行うため、大きなセッションの前に 作業を保存してください。

オーディオ分析とセッションの変更

analyze_audio_file は WAV（整数および浮動小数点）、AIFF／AIFF-C、FLAC、 Ogg Vorbis、MP3、AAC、M4A／MP4（AAC または Apple Lossless）をローカルで読み取ります。 パッケージのインストール時に PyAV デコーダーの依存関係もインストールされます。 ファイル、サンプルレート、チャンネルレイアウト、浮動小数点のヘッドルームを維持し、 圧縮ファイルはデコード後に測定します。分析対象はデフォルトで最初の 30 秒間です （最大 120 秒、処理上限は 3,200 万サンプル）。結果が部分的な場合はその旨を報告します。 測定項目はサンプルピークと RMS で、LUFS やトゥルーピークは含まれません。

session_diff は、実行中のブリッジの識別子を使用して、名前の変更、並べ替え、重複した トラック名を区別します。編集の前後に呼び出してください。最初の呼び出しで比較の 基準が設定されます。更新された Remote Script をインストールして Live を再起動すると、 ブリッジのスナップショット形式がサーバーと一致した状態に保たれます。

ツールセットを絞り込む

サーバーは 156 個のツールを登録します。小規模なタスクに対してモデルが選ぶには、 かなりの数です。ABLETON_TOOLSETS を設定して、必要なグループだけを読み込めます。 たとえば、ABLETON_TOOLSETS=session,tracks,clips,generators のように設定します。 グループ（それぞれが複数のモジュールにまたがる場合があります）：session、tracks、clips、devices、 browser、arrangement、generators、audio、analysis、offline、recipes。 設定を解除すると、すべてが読み込まれます。

規約

• インデックスは0始まりです。時間と長さの単位は拍です。音量にはLiveの0.0〜1.0の フェーダー範囲を使用し、0.85が0 dBです。
• デバイスのパラメーターは、それぞれ固有の範囲を使用します。設定する前に get_device_parameters を実行し、最小値、最大値、表示値を確認してください。
• add_notes_to_clip はクリップのノートを置き換えます。ほかの部分に触れずに少数のノートを 追加または削除する場合は、edit_notes を使用してください。
• セッションのクリップをアレンジメントに配置すると、その下にある内容が上書きされます。セクションを 置き換える場合も同じ方法を使用します。
• トランスポートの応答には、コマンドの実行前の状態が報告されます。 get_session_info で確認してください。

トラブルシューティング

• Control Surfaceの一覧に AbletonMCP が表示されない：フォルダー名は正確に AbletonMCP にする必要があります。また、Liveがスクリプトを読み込むのは起動時だけなので、再起動してください。
• すべてのコマンドがタイムアウトする：Liveでダイアログが開いており、スクリプトをブロックしています。試用版の場合は、起動時に表示される通知です。閉じてから再試行してください。
• ポート9877がリッスンしていない：Liveが起動していないか、Control Surfaceが設定されていません。別のプログラムがすでに9877を使用している場合は、Liveの 起動環境で ABLETON_MCP_PORT を、サーバーで ABLETON_PORT を設定し、両方の値を一致させてください。
• ツールからエクスポートまたはフリーズできない：LiveのAPIにはレンダリングやフリーズの 機能がないため、これらは手動で行う必要があります。レンダリング済みオーディオを使用する場合は、ショートカットでエクスポートし、 ファイルを個別に分析してください。

セキュリティ

Remote Scriptは、認証なしで 127.0.0.1:9877 をリッスンします。ループバックにバインドされているため、ローカルプロセスのみがアクセスできます。ポートを転送したり、バインドアドレスを公開インターフェースに変更したりしないでください。SECURITY.md を参照してください。

開発

ableton_live_mcp/
  server.py        entrypoint: runs the MCP server or a setup subcommand
  app.py           FastMCP app, lifecycle, and server instructions
  connection.py    socket client to the Remote Script
  cli.py           install / uninstall / doctor subcommands
  tools/           session, tracks, clips, devices, browser, arrangement,
                   generators, prompts
  remote_script/
    __init__.py    the Live-side script and its command dispatch tables
tests/             protocol, dispatch-contract, and registration tests

uv run --extra dev pytest      # tests
uvx ruff check .               # lint

CIでは、Python 3.10、3.12、3.13、3.14でリンティング、Remote Scriptのバイトコンパイル、テストを実行します。

よくある質問

Ableton Live MCP Serverとは何ですか？

Claude、Cursor、CodexなどのAIクライアントが、型付きツールを通じてAbleton Liveを調査、操作できるローカルのModel Context Protocolサーバーです。トラックの作成、MIDIの編集、デバイスの読み込みと設定、クリップのアレンジ、セットのミキシング、保存済みの.alsプロジェクトの分析ができます。

ほかのAbleton MCPサーバーとは何が違いますか？

このサーバーは、任意コード実行ツールではなく、検証済みの156個の専用ツールを提供します。破壊的操作／読み取り専用のヒント、ワークフロー用プロンプト、内蔵の音楽生成ツール、ミキシングと分析のツール、オフラインでの.als／.adgの調査機能を備えています。Remote ScriptとMCPパッケージは、同じバージョンで一緒にテストされています。

Ableton Liveを終了した状態でも動作しますか？

リアルタイム制御ツールを使用するには、Ableton Liveと同梱のRemote Scriptが実行されている必要があります。オフラインツールはLiveを起動せずに、保存済みの.als、.adg、.advファイルの要約、調査、リント、MIDIの抽出、差分の確認ができます。

どのMCPクライアントがサポートされていますか？

ローカルのstdio MCPサーバーを起動できるクライアントであれば使用できます。Claude Desktop、Claude Code、Cursor、Codex、互換性のあるIDEなどが含まれます。標準のコマンドは uvx mcp-server-ableton-live です。

これはAbletonの公式製品ですか？

いいえ。これは独立したオープンソースの連携機能であり、Abletonとは提携しておらず、Abletonの承認も受けていません。

クレジットとライセンス

MITライセンスのもと、Wouter Stierhoutがメンテナンスしています。 LICENSE を参照してください。AbletonおよびLiveはAbleton AGの商標です。この独立した オープンソースプロジェクトはAbleton AGとは提携しておらず、Ableton AGの承認も受けていません。