Ableton Control Deck

Ableton Control Deck ist eine lokale MCP-Brücke für Ableton Live. Sie gibt jedem MCP-Client – Claude Code, Claude Desktop, Codex oder jedem anderen, der MCP spricht – exakte, rücklesegeprüfte Kontrolle über Live-Spuren, Clips, Transport, Geräte und Parameter von Drittanbieter-Plugins, plus ein lokales Status-Dashboard.

Alles läuft auf Ihrem Rechner und bindet nur an Loopback-Adressen. Nichts wird veröffentlicht oder dem Netzwerk ausgesetzt.

Ableton und Ableton Live sind Marken der Ableton AG. Dieses Projekt ist ein unabhängiges Community-Tool und wird nicht von Ableton unterstützt oder befürwortet.

Wie es funktioniert

• Ein Live-Remote-Skript (remote-script/Control_Deck/) läuft als Control Surface in Ableton Live und hört auf UDP-Port 50711 auf ein authentifiziertes lokales Anfrageprotokoll. Die von ihm bereitgestellte Live-API ist eine explizite Whitelist, niemals ein generischer Methoden-Ausführer.

• Der MCP-Server (src/index.ts, kompiliert nach dist/) stellt die Live-Steuerung als MCP-Tools bereit und kommuniziert mit dem Remote-Skript über einen abhängigkeitsfreien lokalen UDP-Client (src/ableton-client.ts).

• Ein pro Installation generiertes Geheimnis, erzeugt durch npm run setup und niemals committet, authentifiziert jede Anfrage zwischen den beiden.

• Ein schreibgeschützter Statusdienst (src/dashboard-server.mjs, Port 50712) und ein Next.js-Dashboard (dashboard/, Port 50713) zeigen den Zustand der Brücke, die aktuelle Live-Session, geladene Geräte und ein durchsuchbares lokales Inventar von VST3-, VST2-, Audio-Unit- und CLAP-Plugins.

• Ein optionales Max-for-Live-Device, Control Deck OmniHost (max-for-live/), hostet ein VST3-Instrument direkt und stellt seinen vollständigen veröffentlichten Parameterkatalog – tausende Parameter, weit über Live's automatisches Device-Panel hinaus – über seinen eigenen Loopback-Kanal (UDP 50714) bereit.

• Ein optionaler nativer macOS-Wrapper (macos/) zeigt das Dashboard in einem WebKit-Fenster, das auf die lokale Adresse beschränkt ist; externe Navigation wird blockiert.

• Ein optionaler lokaler SQLite-Sample-Index (src/sample-index.ts) macht ein externes Sample-Laufwerk durchsuchbar nach Stichwort, BPM, Tonart und One-Shot/Loop-Art, ohne jemals in das Quell-Audio zu schreiben.

Related MCP server: io.github.peterkolbe/ableton-for-ai

Designregeln

• Änderungen an Spuren und Geräten erfordern sowohl den Index als auch den exakten aktuellen Namen; veraltete Namen werden abgelehnt.

• Das Laden von Plugins erfolgt über Live's eigenen Browser-Index und lehnt mehrdeutige Namen ab, anstatt zu raten.

• Destruktive Operationen (delete_track, Index-Neuerstellungen) erfordern explizite Bestätigungsflags.

• Jeder Mutation folgt eine separate Rückleseabfrage, und das Tool meldet den Wert, den Live tatsächlich anzeigt.

• Abgeschlossene Anfrage-IDs werden von der Brücke zwischengespeichert, sodass eine doppelte UDP-Anfrage niemals eine Mutation zweimal ausführen kann.

Werkzeuge

• Status, Transport, Tempo, Taktart und Songposition mit Rückleseprüfung

• Spuren auflisten, erstellen, umbenennen und sicher löschen

• MIDI-Clips in der Session-Ansicht erstellen und validierte Noteninhalte schreiben

• Szenen, Clips, Auswahl, Geräte und jeden von Live offengelegten Parameter inspizieren

• VST3/VST2/AU-Plugins über Live's Browser auf einer bestimmten Spur finden, auflösen und laden

• Native Live-Geräte (Drum Rack, Echo, Reverb, ...) nach exaktem Browser-Namen mit Ablehnung von Mehrdeutigkeiten laden

• Parameter von Drittanbieter-Plugins mit normalisierten Werten und Rückleseprüfung lesen und setzen

• Ein vollständig indiziertes VST3-Instrument über OmniHost steuern, über Live's Parameterobergrenze hinaus

• Ein lokales Sample-Verzeichnis nach Stichwort, Ordner, BPM, Tonart, Dauer und Tags durchsuchen

Voraussetzungen

• macOS 13 Ventura oder neuer (Apple Silicon und Intel) — macOS ist derzeit die einzige unterstützte Plattform. Der Kern ist plattformneutral und ein Linux/Windows-Port ist gut abgesteckt; siehe PORTING.md.

• Ableton Live 11 oder neuer (getestetes Ziel: Live 12)

• Node.js 20+

• Max for Live (optional – nur für das OmniHost-Device)

Die vollständige Dokumentation – Komponentenbeschreibungen, Live-Einrichtung, die vollständige MCP-Tool-Referenz, Fehlerbehebung und Deinstallation – befindet sich in HELP.md.

Installation

Schnellstart (keine Programmierkenntnisse erforderlich)

1. Node.js installieren – die LTS-Version von nodejs.org herunterladen und den Installer mit den Standardoptionen ausführen. (Control Deck läuft darauf; Sie müssen sich nie wieder darum kümmern.)

2. Control Deck herunterladen – den grünen Code → Download ZIP-Button auf GitHub verwenden, entpacken, und den Ordner an einen dauerhaften Ort verschieben, z.B. in Ihren Home-Ordner. Lassen Sie ihn nicht im Downloads-Ordner – der Installer bindet die Dienste an den Speicherort des Ordners und wird Sie bitten, ihn zu verschieben.

3. Das Installationsprogramm ausführen – mit Rechtsklick auf Install Ableton Control Deck.command und Öffnen wählen (macOS erfordert beim ersten Mal für heruntergeladene Dateien den Rechtsklick). Es installiert alles, startet die Hintergrunddienste und öffnet den Verbindungsleitfaden, wenn es fertig ist. Es kann jederzeit erneut ausgeführt werden.

4. Die Control Surface in Live aktivieren – Einstellungen → Link, Tempo & MIDI → Control Deck in einem freien Control Surface-Slot auswählen (Live zuerst neu starten, wenn es während der Einrichtung geöffnet war).

5. Ihren KI-Agenten verbinden – der geöffnete Leitfaden (http://127.0.0.1:50713/connect) enthält Kopier-Einfügen-Anleitungen für jeden Client.

Entwickler-Setup

npm run setup ist die gleiche Engine, die der Installer verwendet – Abhängigkeiten installieren, TypeScript + OmniHost + Dashboard-Builds, installationsspezifisches Geheimnis, Remote-Skript-Installation und launchd-Agents (geschrieben und aktiviert). Es ist idempotent; führen Sie es erneut aus, nachdem Sie Änderungen gezogen oder das Working Directory verschoben haben.

npm run setup

Flags für eine engere Schleife: --skip-build (keine npm-Installationen/Builds), --skip-remote-script, --skip-agents. Die granularen Teile sind weiterhin als einzelne Skripte verfügbar (build, build:omnihost, install:omnihost, index:plugins, samples:index und das eigene dev/build/check des Dashboards).

Was das Setup verwaltet:

1. ein installationsspezifisches Geheimnis unter data/bridge-token (vom Remote-Skript und den Clients gemeinsam genutzt; niemals committet),

2. das Remote-Skript (mit eingestempeltem Geheimnis) unter ~/Music/Ableton/User Library/Remote Scripts/Control_Deck/,

3. zwei launchd-Agents, die auf dieses Working Directory verweisen: com.abletondeck.api und com.abletondeck.dashboard.

Dann fügen Sie den MCP-Server zu Ihrem Client hinzu. Zum Beispiel für Claude Code:

claude mcp add ableton -- node /path/to/ableton-control-deck/dist/src/index.js

Öffnen Sie in Live Einstellungen → Link, Tempo & MIDI und bestätigen Sie, dass Control Deck als Control Surface ausgewählt ist.

Verbinden anderer Agenten

Die Connect-Seite des Dashboards (http://127.0.0.1:50713/connect) enthält Kopier-Einfügen-Setup-Anleitungen – gerendert mit dem tatsächlichen Installationspfad Ihres Rechners – für Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Grok CLI, vollständig lokale LLM-Umgebungen (LM Studio, Ollama via mcphost) und jeden anderen MCP-Client, plus eine ehrliche Diskussion darüber, was es bräuchte (und kosten würde, sicherheitstechnisch), um die Brücke für entfernte Verbindungen wie claude.ai zu öffnen. Die Kurzfassung: Jeder Agent, der einen stdio-MCP-Server starten kann, kann Live steuern; entfernte Cloud-Connectors sind bewusst außerhalb des Rahmens.

Control Deck Dashboard

Öffnen Sie das Dashboard unter http://127.0.0.1:50713 (es startet bei der Anmeldung, wenn Sie die launchd-Agents aktiviert haben). Es zeigt den Zustand der Brücke, die aktuelle Live-Session, die Gerätekette der ausgewählten Spur und ein durchsuchbares lokales Inventar installierter Plugins. Die Einstellungsseite steuert die Brückenverbindung, das Aktualisierungsverhalten, Bibliotheksvorgaben, Dichte, Farbe und Bewegung. Projektänderungen verwenden weiterhin die exakten, rücklesegeprüften MCP-Tools.

Die optionale native App wird mit npm run build:macos als Ableton Control Deck.app erstellt.

Lokale Befehle

npm run check          # type-check + syntax-check all sources
npm test               # unit tests (client, tools, validation, safety)
npm run test:bridge    # remote-script protocol tests (Python)
npm run index:plugins  # rebuild the local plug-in inventory
npm run samples:index  # refresh the sample index
npm run build:macos    # build the native wrapper app

Das Dashboard hat eine eigene Build-Prüfung:

cd dashboard
npm run check

Sicherheitsmodell

• Die Brücke hört nur auf 127.0.0.1 UDP 50711; der Statusdienst, das Dashboard und OmniHost binden alle nur an Loopback.

• Jede Brückenanfrage muss das installationsspezifische Geheimnis aus data/bridge-token enthalten. Das Remote-Skript weigert sich zu starten, wenn das Geheimnis nie eingestempelt wurde.

• Die Live-API-Oberfläche ist eine explizite Whitelist mit Sicherheitsvorkehrungen für exakte Ziele, sodass ein verwirrter Agent lautstark scheitert, anstatt die falsche Sache zu bearbeiten.

• Der MCP-Server protokolliert Anfragen lokal in logs/control-deck.jsonl, damit Sie überprüfen können, was ein Agent getan hat.

Lizenz

MIT