ableton-mind — Ableton Live MCP server について
ableton-mindは、Live Object Modelを通じてAbleton Liveを調査・操作するMCPサーバーです。デバイス知識や音楽レシピ、スナップショット差分による検証を備え、現在はalpha版でAPIは不安定です。
主な機能
- 01Live Object Modelへのアクセス
- 0255種類のデバイス知識
- 0314種類の音楽レシピ
- 04スナップショット差分検証
- 05イベントリスナー
- 06オートメーションとPush制御
活用シーン
- 01Ableton Liveセットの確認と編集
- 02デバイスレシピを使った作曲
- 03セッションスナップショットで変更を確認
MCP 対応
MCPクライアントにAbleton Liveのツール、リソース、プロンプトを提供します。TCPとJSON-RPCでLive内のPython Remote Scriptに接続します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
36掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| from_beginning | boolean | いいえ | true の場合、曲を最初から再生し直します。デフォルトは false(再生を続行)です。 |
詳細
ableton-mind
Ableton Live 向けの決定版 MCP(Model Context Protocol)サーバーです。組み込みのネイティブデバイスナレッジベース、宣言型の音楽レシピ、統合された検証ループ、リアクティブリスナーを備え、LLM(Claude、Cursor など)に Live Object Model の全機能を公開します。
ステータス:alpha / v0.1.1 公開済み — Ableton Live 12.4.1(macOS)でコアのスモークテストに合格し、パッケージの検証も完了しています。npm、GitHub Release
.mcpb、MCP Registry は公開済みです。Glama には掲載されていますが、ホスト側のリリース/デプロイは Glama 管理画面のビルドフローとは別途公開する必要があります。Smithery のメタデータは登録済みですが、インデックスへの反映が遅れる場合があります。API は不安定です。まだ本番環境では使用しないでください。Phase 8 のステータス:スライス 1 では、読み取り専用の Max for Live/プラグインのイントロスペクションと、Link/リモートのステータス検出を提供します。より高度な M4L 制御、VST3 サイドカー、リモート DAW 統合、モバイルコンパニオンの作業は保留中です。
📚 完全なドキュメント: pantani.github.io/ableton-mind/
アーキテクチャ(3 層)
Claude/Cursor ──MCP/stdio──▶ ableton-mind (TS, Node 20+) ──TCP NDJSON JSON-RPC──▶ Remote Script (Python, inside Live)
src/— TypeScript 製の MCP サーバーです。ツール、リソース、プロンプト、TCP クライアント、レシピランナー、ナレッジローダーを含みます。live/AbletonMind/— Python Remote Script です。ポート9876で TCP サーバーを起動し、JSON-RPC を LiveAPI にディスパッチします。recipes/、src/knowledge/— 組み込みの JSON(ドラムキット、ベースライン、ラック、デバイススキーマ)です。
完全な仕様は PLAN.md をご覧ください。固定されたコントラクトは _workspace/contracts/ にあります。
既存の MCP/OSC サーバーとの比較
| 機能 | ahujasid/ableton-mcp | AbletonOSC + MCP wrapper | ableton-mind |
|---|---|---|---|
| MCP ツール | 22 | ~30 | 36 |
| LOM のカバレッジ | ~10% | ~95% | ~100% |
| ナレッジベース | なし | なし | 55 種類のデバイス、スケール、ドラムキット |
| レシピ | なし | なし | 7 カテゴリにわたる 14 件 |
| 検証ループ | なし | なし | あり(統合済み:session_snapshot/diff) |
| レンダープレビュー | なし | なし | あり(現在はスナップショット、バウンスは予定) |
| リアクティブリスナー → MCP 通知 | なし | 一部(OSC) | あり(7 つのイベントが利用可能) |
| トランザクション(単一の取り消し単位) | なし | なし | あり |
| オートメーションエンベロープ | なし | 一部 | 完全対応(linear / hold) |
| Push 1/2/3 の制御 | なし | なし | あり(パッド/ボタン/モード LED) |
| Docker | なし | なし | あり |
.mcpb ワンクリック | なし | なし | あり |
| Doctor CLI | なし | なし | あり |
要件
- Node 20+
- Ableton Live 12(優先。Live 11 もサポート)
- macOS(主な対象)、Windows(Phase 1 最終版)
セットアップ(ソースからインストール)
npm install
npm run typecheck
npm run lint
npm run test
npm run build
Remote Script のインストール(Python ブリッジ)
開発モード(シンボリックリンク):
node scripts/install-remote-script.mjs # creates symlink
node scripts/install-remote-script.mjs --check # status only
node scripts/install-remote-script.mjs --copy # full copy (CI / snapshot)
手動:
- macOS:
live/AbletonMind/を~/Music/Ableton/User Library/Remote Scripts/AbletonMind/にコピーします - Windows:
live/AbletonMind/を~/Documents/Ableton/User Library/Remote Scripts/AbletonMind/にコピーします
次に、Live → Preferences → Link/Tempo/MIDI → Control Surface → AbletonMind を選択します。
スモークテスト:docs/smoke-test.md。
MCP サーバーの起動
npm run build
node dist/index.js
環境変数:
| 変数 | デフォルト | |
|---|---|---|
ABLETON_MIND_HOST | 127.0.0.1 | Python ブリッジのホスト |
ABLETON_MIND_PORT | 9876 | ブリッジの TCP ポート |
ABLETON_MIND_TIMEOUT_MS | 5000 | リクエストごとのタイムアウト |
ABLETON_MIND_MAX_FRAME_BYTES | 1048576 | 受信する JSON-RPC フレームの最大サイズ |
ABLETON_MIND_MAX_PENDING_REQUESTS | 128 | 同時に処理中の JSON-RPC 呼び出しの最大数 |
ABLETON_MIND_LOG_LEVEL | info | debug | info | warn | error |
ローカルコパイロット
厳選した同じ Ableton ツール群に対して、ローカル LLM を実行します。
ollama pull qwen2.5:3b # optional; the UI can pull too
node dist/index.js chat # opens http://127.0.0.1:4142
node dist/index.js ask "What is in this set?"
デフォルトのティアは読み取り専用(safe)です。簡単な変更には --write を、レシピ/ブラウザーの読み込みには --creative を使用してください。
| 変数 | デフォルト | |
|---|---|---|
ABLETON_MIND_LLM_BASE_URL | http://127.0.0.1:11434/v1 | OpenAI 互換エンドポイント |
ABLETON_MIND_LLM_MODEL | qwen2.5:3b | ローカルモデル ID |
ABLETON_MIND_LLM_TIER | safe | safe | standard | creative |
ABLETON_MIND_CHAT_PORT | 4142 | ブラウザー UI のポート |
ローカルコパイロットを参照してください。
Doctor CLI
npx ableton-mind-doctor
Node のバージョン、Remote Script のインストール状況、ブリッジのポート、ナレッジベースの整合性、レシピを確認します。
配布
- npm:
npm install -g ableton-mind。 - Claude Code プラグインマーケットプレイス:
claude plugin marketplace add Pantani/ableton-mindを実行し、続けてclaude plugin install ableton-mind@ableton-mindを実行します。 - Claude Desktop ワンクリック: v0.1.1 GitHub リリースから
ableton-mind-0.1.1.mcpbをダウンロードします。 - MCP Registry:
io.github.Pantani/ableton-mindは公式レジストリに登録済みです。 - Glama: glama.ai/mcp/servers/Pantani/ableton-mindに掲載されています。ホスト版のリリースは GitHub Release とは別で、引き続き Glama 管理者によるデプロイと Make Release の手順が必要です。
- ソース:
npm ci && npm run build && npm run install:remote-script。 - Docker:
docker build -t ableton-mind . && docker run --rm -i --network host ableton-mind。 - Smithery:
smithery.yamlは掲載/インデックス登録の準備ができています。
ロードマップ
PLAN.md §12および_workspace/PROGRESS.mdを参照してください。
| フェーズ | 状況 |
|---|---|
| 0 — スパイク | ✅ 実環境でのスモークテストに合格 |
| 1 — ahujasid との同等性 | ✅ 22/22 |
| 2 — リスナー | ✅ 7 イベント |
| 3 — ナレッジ | ✅ 55 デバイス |
| 4 — オートメーションエンベロープ | ✅ |
| 5 — プレビュー/検証 | ✅ スナップショット+差分(バウンスは計画中) |
| 6 — プッシュ | ✅ パッド/ボタン/モード LED |
| 7 — 配布 | ✅ DXT/Docker/Smithery/CI/リリースの準備完了 |
| 8 — ロングテール | 🔵 スライス 1 を提供済み:読み取り専用の M4L/プラグインのイントロスペクション+Link/リモートステータスの検出。より深い M4L/VST3/リモート DAW/モバイル対応は今後予定 |
ライセンス
MIT。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。