Skip to content

live-connector v3.0.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@artouc artouc released this 03 Jul 09:42
v3.0.0
542371f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

live-connector v3.0.0 は、v2.17.18 以降の MCP ツール表面を 39 件から 4 件（meta / do / undo / render）へ全面統合したメジャーリリースです。破壊的変更を含みます。

変更内容

4 ツール・タクソノミー

人間の操作タクソノミーに沿った 4 動詞:

動詞 ツール 役割
入口 meta サービス情報、LOM スキーマ、do 文法契約、例文、時刻座標、仮想ラベル、Live Set overview
見る・変える do Cypher 文による読み取り（MATCH … RETURN）と書き込み（SET / CREATE / DELETE / COPY）
聴く render AudioTrack の Pre-FX オーディオレンダリング（同期または background:true ジョブ）
戻す undo do 書き込みの逆操作を LIFO で適用（steps または writeId）

Cypher 書き込み方言

  • SET: MATCH (n:Label {...}) SET n.prop = <value>
  • CREATE: standalone / anchored（Device / Clip / Note）
  • DELETE: MATCH … [DETACH] DELETE n
  • COPY: Track / Scene / Device の複製

応答・ガードレール

  • 書き込み応答は差分のみ（changed / created / deleted / copied）
  • マッチ 0 件は {status:"no_match", matched:0, hint}
  • 全書き込みは inverse diff を undo ログ（storageDirectory/undo/undo-log.jsonl）へ記録
  • undoable: full | partial | none を宣言。partial / none は confirm:true 必須
  • 仮想ラベル WriteEvent（undo ログ）/ RenderJob（render ジョブ）を do read で照会可能

廃止ツール

query / set_* / create_* / delete_* / duplicate_* / render_audio / batch / get_write_history / list_snapshots / restore_snapshot / search_presets / save_device_state / apply_device_state / verify_device_catalog など旧 39 ツール名は存在しません。対応表は llm/version/3.0.0.md を参照してください。

制約

  • 破壊的変更: MCP クライアントは 4 ツール表面へ移行必須
  • undo の復元忠実度は宣言どおり段階的（Track 削除 = none、third-party Device 削除 = none、カスタム warp = partial）
  • SDK に undo API が無い前提は維持。inverse diff 合成と blueprint recreate による MCP 側 undo

インストール

  1. このリリースに添付されている live-connector-3.0.0.ablx をダウンロードします。
  2. Ableton Live の Preferences → Extensions に .ablx をドロップします。
  3. Developer Mode を OFF にして Ableton Live を再起動します。
  4. MCP クライアントから http://127.0.0.1:7799/api/v1/mcp に接続します。
    • ヘルスチェック: http://127.0.0.1:7799/health

Claude Code では、初回に次の登録を行います。

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

更新手順

  1. このリリースに添付されている live-connector-3.0.0.ablx をダウンロードします。
  2. Ableton Live の Preferences → Extensions に新しい .ablx をドロップします。
  3. Ableton Live を再起動します。
  4. URL が http://127.0.0.1:7799/api/v1/mcp のままであれば、Claude Code の再登録は不要です。

備考

  • Ableton Live Beta + Extensions SDK（beta）前提のため pre-release として公開します。
  • 関連: #139 / PR #137
  • 推奨フロー: meta → do read → do write (preview/confirm) → render → undo
Assets 3
Loading