Skip to content

Setup

Jump to bottom
Daisuke Tsukada edited this page Sep 5, 2026 · 1 revision

セットアップ

LiveMCP は M4L デバイス 1 個を Live のトラックに置くだけで動きます。外部プロセスは要りません。

動作要件

要件
Ableton Live 12.4 以上 + Max for Live（Suite または M4L 追加）。replace_sample が 12.4+、create_audio_clip が 12.0.5+ の LOM API
Node.js 22 以上（.als 系スクリプトと Loopcloud DB の読み取りに node:sqlite を使う）
Claude Code HTTP トランスポートの MCP を登録できるもの

1. ビルドと導入

git clone git@github.com:dsgarage/LiveMCP.git && cd LiveMCP
npm --prefix server install
npm run install-device

install-device で次が行われます。

  1. server/src を esbuild で device/code/mcp-server.js にバンドル
  2. device/LiveMCP.maxpat から device/LiveMCP.amxd を生成（scripts/amxd.js。Max エディタでの保存は不要）
  3. .amxd と 2 つの .js を User Library と Max の検索パスへ配置
~/Music/Ableton/User Library/Presets/Audio Effects/Max Audio Effect/LiveMCP/
├── LiveMCP.amxd
├── livemcp-server.js   ← node.script が読む（バンドル済み）
└── livemcp-bridge.js   ← js が読む

~/Documents/Max 9/Library/
├── livemcp-server.js
└── livemcp-bridge.js

Live 上のデバイスからは .amxd と同じフォルダが Max の検索パスに入りません。js も node.script もスクリプトを検索パスから解決するため、2 つの .js は Max の標準ユーザーライブラリにも置きます。他のパッチと共有の場所なので、ファイル名は livemcp- 接頭辞で固定です。

2. Live へロード

Live のブラウザから User Library → Presets → Audio Effects → Max Audio Effect → LiveMCP を任意のトラックへドラッグします。

  • サーバーは 1 インスタンスだけ動けばよいので、セット内に 1 つだけ置きます
  • テンプレートセットに含めておくと Live 起動と同時に立ち上がります
  • ポートは既定 3360（デバイス側の環境変数 LIVEMCP_PORT で変更）

3. Claude Code へ登録

claude mcp add --transport http live-mcp http://localhost:3360/mcp

4. サンプルフォルダ

未設定でも Node 側が次を自動検出します。

  • ~/Music/Ableton/User Library/Samples
  • ~/Music/Ableton/Factory Packs
  • Live の Core Library Samples

追加するときはデバイス内の folders メッセージボックスを編集してクリックします（絶対パス、空白は " " で囲む。Max は ~ を展開しません）。

folders "/Users/you/My Samples" /Volumes/Audio/Loops

環境変数 LIVEMCP_SAMPLE_DIRS（: 区切り）でも指定できます。1 回きりなら live.samples.search の folder 引数で足ります。

5. 動作確認

Claude Code で:

live.status を実行して

Live のバージョンが返れば接続完了です。返らないときは トラブルシューティング へ。

任意: Remote Script（ステータスバー通知）

.als を書き換える系のツールは、結果を Live のステータスバーに出します。この通知は M4L からは出せないため、検証用 Remote Script を入れると表示されるようになります（入れなくても動作します）。

node scripts/install-remote-script.js

Live を再起動し、環境設定 → Link/Tempo/MIDI の Control Surface で LiveMCP_Probe を選びます。詳細は Remote Script。

任意: Loopcloud

Loopcloud のパックを Live のプロジェクトへ起こす機能（Reference-Loopcloud）は、Loopcloud アプリが同期したライブラリ（~/Library/Loopcloud/library）とローカル DB（~/Library/Loopcloud/<アカウント>/local.db）を読みます。DB は読み取り専用で開き、書き込みやロックはしません。

デバイスを更新したとき

server/src や device/code/live-bridge.js を変えたら npm run install-device を再実行します。

Max はパッチもスクリプトもファイルパス単位でキャッシュします。 同じパスの .amxd を差し替えても Live のセッション中は古いパッチが使われます。反映には Live の再起動が必要です（デバイスの削除・再追加では足りません）。

はじめに

リファレンス

開発

Clone this wiki locally