live-connector

An MCP server that lets AI agents read and write an Ableton Live Set as a graph. Ableton Live の Live Set を、AI エージェントがグラフとして読み書きできるようにする MCP サーバーです。

English

Quick start

1. Get the .ablx. Download live-connector-3.2.2.ablx from Releases, or run pnpm package in the repository; it writes the file to apps/extension/dist/.

2. In Live, open Preferences → Extensions and choose the .ablx, or drop it onto the page.

3. Turn Developer Mode OFF and restart Live.

4. Check that it is running, and register it with Claude Code.

curl http://127.0.0.1:7799/health
claude mcp add --transport http live-connector http://127.0.0.1:7799/api/v1/mcp --scope project

If /health returns {"status":"pass","version":"3.2.2",...}, the server is up.

Restart Claude Code, open a Live Set, and try asking:

• "List the tracks and devices in this Live Set."

• "Create a MIDI track called Bass and add Wavetable to it."

• "Mute the Drums track. Actually, undo that."

• "What is the current value and range of Operator's Cutoff?"

Technology

Tracks, devices, parameters and clips are exposed as nodes and relationships, and agents read and write them with the same Cypher.

MATCH (:Track {name:"Drums"})-[:HAS_DEVICE]->(:Device {name:"Operator"})-[:HAS_PARAM]->(p:Parameter {name:"Cutoff"})
RETURN p.value, p.min, p.max

MATCH (t:MidiTrack {name:"Bass"}) CREATE (t)-[:HAS_DEVICE]->(d:Device {name:"Wavetable"})

meta returns the complete list of labels and the grammar at runtime.

live-connector is a Live Extension, so there is no Remote Script or separate process to set up. The MCP server starts with Live and serves Streamable HTTP on a loopback address.

The SDK has no undo API, so live-connector records the operations that reverse each do write under a writeId. undo applies them newest first, or for a specific writeId. Each write is marked full, partial or none depending on how completely it can be restored; partial and none require confirmation. Query the history with MATCH (e:WriteEvent) RETURN e.

The log is kept as JSONL in the Extension's storage directory, up to 200 entries. When the SDK gains an undo API, this mechanism will be replaced.

Set editing goes through the SDK. Transport control and Main output capture go through AbletonOSC, because the SDK has no API for them. OSC writes are read back to confirm they took effect, and a failed write is never retried automatically on the other backend.

Main output capture records the finished signal, including MIDI instruments and the devices on Main, by recording the Resampling input in real time. Pass source:"main" to render and go through two steps.

{"source":"main","startTime":0,"endTime":64,"preview":true}

{"source":"main","startTime":0,"endTime":64,"background":true,"confirm":true,"planId":"plan-...","requestId":"capture-001"}

startTime and endTime are zero-based quarter-note beats. During capture a temporary track is created and loop, punch and record mode are changed, then everything is restored. Other writes, undo, and another render are rejected until it finishes. Check progress with MATCH (j:RenderJob {id:"..."}) RETURN j.phase, j.progressFraction.

Specification

The recommended flow is meta, then do reads, do writes, render, and undo when needed.

Related MCP server: Graph-Mem MCP

日本語

クイックスタート

1. .ablx を用意します。Releases から live-connector-3.2.2.ablx をダウンロードするか、リポジトリで pnpm package を実行すると apps/extension/dist/ に生成されます。

2. Live の Preferences → Extensions で .ablx を選ぶか、ページにドロップします。

3. Developer Mode を OFF にして Live を再起動します。

4. 起動を確認し、Claude Code に登録します。

curl http://127.0.0.1:7799/health
claude mcp add --transport http live-connector http://127.0.0.1:7799/api/v1/mcp --scope project

/health が {"status":"pass","version":"3.2.2",...} を返せば起動しています。

Claude Code を再起動し、Live Set を開いた状態で次のように頼んでみてください。

• 「今の Live Set のトラックとデバイスを一覧にして」

• 「Bass という MIDI トラックを作って Wavetable を挿して」

• 「Drums トラックをミュートして。やっぱり戻して」

• 「Operator の Cutoff の現在値と範囲を教えて」

テクノロジー

トラック、デバイス、パラメータ、クリップをノードと関係として公開し、エージェントは読み取りも書き込みも同じ Cypher で行います。

MATCH (:Track {name:"Drums"})-[:HAS_DEVICE]->(:Device {name:"Operator"})-[:HAS_PARAM]->(p:Parameter {name:"Cutoff"})
RETURN p.value, p.min, p.max

MATCH (t:MidiTrack {name:"Bass"}) CREATE (t)-[:HAS_DEVICE]->(d:Device {name:"Wavetable"})

ラベルの完全な一覧と文法は、実行時に meta が返します。

live-connector は Live の Extension なので、Remote Script や別プロセスを用意する必要はありません。MCP サーバーは Live と一緒に起動し、loopback アドレスで Streamable HTTP の接続を受け付けます。

SDK には undo の API がないため、do の書き込みごとに、それを打ち消す操作を writeId と一緒に記録します。undo は記録を新しいものから順に、または writeId を指定して適用します。書き込みは、元に戻せる度合いに応じて full、partial、none のどれかに分類され、partial と none の取り消しには確認が必要です。履歴は MATCH (e:WriteEvent) RETURN e で確認できます。

記録は Extension の保存領域に JSONL で最大 200 件まで残ります。SDK に undo の API が追加されたら、この仕組みを置き換える予定です。

Set の編集は SDK で行います。再生の操作と Main 出力の録音は、SDK に API がないため AbletonOSC で行います。OSC での書き込みは読み戻して反映を確かめ、失敗した書き込みをもう一方の経路で自動的にやり直すことはしません。

Main 出力の録音では、MIDI 楽器の実音や、Main 上のデバイスを通した完成形の音を、Resampling 入力の実時間録音で取得します。render に source:"main" を渡し、計画の取得と実行の 2 段階で進めます。

{"source":"main","startTime":0,"endTime":64,"preview":true}

{"source":"main","startTime":0,"endTime":64,"background":true,"confirm":true,"planId":"plan-...","requestId":"capture-001"}

startTime と endTime は 0 始まりの四分音符の拍数です。録音中は一時トラックを作り、loop、punch、record mode を一時的に変更し、終了後に元へ戻します。録音が終わるまで、ほかの書き込み、undo、別の render は受け付けません。進捗は MATCH (j:RenderJob {id:"..."}) RETURN j.phase, j.progressFraction で確認します。

仕様

推奨する順序は、meta、do での読み取り、do での書き込み、render です。必要なら最後に undo で戻します。