Ableton Live MCP

Ein MCP-Server für Ableton Live 12, basiert auf dem offiziellen Ableton Extensions SDK. Der MCP-Server läuft innerhalb von Live als Erweiterung — kein Bridge-Prozess, keine MIDI-Remote-Skripte. Jeder MCP-Client (Claude Code, Claude Desktop, Cursor, ...) verbindet sich über streamable HTTP und erhält volle programmatische Kontrolle über das Live-Set: Spuren, Clips, MIDI-Noten, Geräte, Parameter, Mixer, Szenen, Warping, Rendering und mehr.

MCP client (Claude, ...) ──streamable HTTP──▶ http://127.0.0.1:8722/mcp
                                                      │
                                     Live Extension Host (Node.js)
                                                      │
                                              Ableton Live 12

Voraussetzungen

• Ableton Live 12.4.5 oder neuer (Extensions-Unterstützung)

• Node.js >= 24.14 (nur Build)

Related MCP server: ableton-agent-mcp

Installation

npm install
npm run package        # builds and produces Ableton-Live-MCP-<version>.ablx

Ziehen Sie in Live die .ablx-Datei auf Einstellungen → Erweiterungen. Der MCP-Endpunkt startet zusammen mit Live unter http://127.0.0.1:8722/mcp (GET /health für einen schnellen Check).

Entwicklermodus

Aktivieren Sie in Live Einstellungen → Erweiterungen → Entwicklermodus und führen Sie dann Folgendes aus:

npm start              # builds and runs the extension against the running Live

Die .env-Datei muss auf Ihre Live-Installation verweisen, z. B.:

EXTENSION_HOST_PATH=/Applications/Ableton Live 12 Beta.app.

Client verbinden

Claude Code:

claude mcp add --transport http ableton-live http://127.0.0.1:8722/mcp

Claude Desktop (oder ein Client, der nur stdio unterstützt) über mcp-remote:

{
  "mcpServers": {
    "ableton-live": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:8722/mcp"]
    }
  }
}

Konfiguration

Der Port wird in config.json im Speicherverzeichnis der Erweiterung gespeichert (wird beim ersten Start erstellt; der Pfad wird von song_get unter environment.storage_directory gemeldet). Standard:

{ "port": 8722 }

Funktionsweise

• Jedes Live-Objekt (Spur, Clip, Gerät, Parameter, ...) wird über eine stabile Objekt-ID angesprochen, die über die Auflistungs-Werkzeuge (song_get, track_get, device_get, ...) ermittelt wird.

• IDs bleiben gültig, bis das Objekt gelöscht oder verschoben wird, oder bis ein anderes Live-Set geladen wird. Veraltete IDs führen zu einem Fehler, der den Client zum erneuten Auflisten auffordert.

• Alle Zeit- und Positionsangaben erfolgen in Beats; Farben werden als #RRGGBB angegeben; MIDI-Tonhöhen liegen zwischen 0 und 127.

• Schreibvorgänge mit mehreren Werten (parameter_set) werden in Live zu einem einzigen Undo-Schritt zusammengefasst.

Werkzeuge

Song

Spuren

Szenen & Cue-Punkte

Clips

Geräte & Racks

Parameter & Mixing

Dateien & Rendering

UI & Befehle

Skills

skills/ableton-live/SKILL.md ist ein installierbarer Agent-Skill, der einem MCP-Client beibringt, diese Werkzeuge gut zu nutzen (ID-Ermittlungsablauf, Beats vs. Sekunden, Notenbearbeitungs-Muster, Geräte-Workflows). So installieren Sie den Skill für Claude Code:

mkdir -p ~/.claude/skills && cp -r skills/ableton-live ~/.claude/skills/

Typische Dinge, die Sie einen verbundenen Assistenten bitten können:

• Ein 4-Bar-House-Drum-Pattern auf einer neuen MIDI-Spur mit einem Drum Rack erstellen

• Alle Clips auf der Drum-Spur im Modus „Complex Pro" warpen

• Jede Spur außer dem Vocal-Bus um 3 dB absenken

• Ein Song-Gerüst aus Intro-, Strophe- und Chorus-Szenen mit Locators bauen

• Das Sample im Simpler mit /path/to/kick.wav ersetzen und es auf C1 mappen

Einschränkungen

• Die Erweiterung (und damit der MCP-Endpunkt) läuft nur, solange Live geöffnet ist.

• Es können nur eingebaute Live-Devices eingefügt werden; Drittanbieter-Plug-ins können vom SDK nicht geladen werden.

• Keine Transportsteuerung (Wiedergabe/Stopp/Aufnahme) und kein Clip-Launching — die Extensions API v1.0.0 stellt sie nicht bereit. Gleiches gilt für den Browser-Zugriff und Parameter-Automationskurven.

• show_dialog blockiert, bis der Benutzer den Dialog in Live schließt.

Tests

npm test                  # E2E against a mock Extension Host: MCP client ↔ HTTP ↔ all tools
node test/live-smoke.mjs  # against a real running Live with the extension loaded

Der Live-Smoke-Test erstellt eigene Spuren/Clips/Devices, prüft jede Tool-Familie (MIDI-Noten, Warping, Drum-Racks, Rendering, ...) und löscht alles, was er erstellt hat.

Extension-Host-Eigenheiten (wissenswert)

Zwei Verhaltensweisen des Beta-Extension-Hosts, die dieses Projekt umgeht:

1. Leerer VM-Kontext. Erweiterungen werden in einem V8-Kontext ohne global oder Web-Globals (Request, Response, ReadableStream, fetch, EventTarget, ...) ausgeführt, die das MCP-SDK beim Laden benötigt. build.ts injiziert einen Banner, der sie aus dem Node-Hauptkontext nachzieht (Core-Modul-Funktionen werden geteilt, daher läuft ihr Function-Konstruktor dort). Siehe build.ts für Details.

2. bigint-Werte. Der Host gibt für einige Werte, die das SDK als number typisiert, bigint zurück (Clip-Farben, Noten-Pitches, ...). src/serialize.ts normalisiert das mit num(), bevor Arithmetik bzw. JSON verarbeitet wird.

3. Asynchrone Schreibvorgänge. Die Property-Setter des SDK (Noten, Namen, Werte) kehren zurück, bevor Live die Änderung übernommen hat; ein Lesevorgang innerhalb weniger zehn Millisekunden kann den vorherigen Zustand zurückgeben. Agenten merken das selten, aber Read-after-Write-Tests müssen es kurz erneut versuchen (siehe eventually() in test/live-smoke.mjs).

Außerdem: Wenn der Dev-Extension-Host abstürzt, verweigert Live möglicherweise den nächsten Control-Channel-Handshake („bring-up timed out“) — starte Live neu und führe npm start erneut aus.

Fehlerbehebung

• Endpunkt antwortet nicht: prüfe curl http://127.0.0.1:8722/health. Rechtsklick auf eine beliebige Spur in Live — die Kontextmenü-Aktion „Ableton Live MCP: Status“ zeigt den Endpunkt, an den die Erweiterung tatsächlich gebunden ist.

• Port bereits belegt: Wenn ein anderer Prozess den konfigurierten Port belegt, protokolliert der Server den Fehler in der ExtensionHost.txt und startet nicht. Ändere port in der config.json der Erweiterung (Pfad wird durch song_get unter environment.storage_directory angezeigt) — die Datei wird nur einmal beim Start gelesen, starte Live also danach neu.

• config.json geändert, aber nichts passiert: Die Konfiguration wird nur gelesen, wenn die Extension startet. Starte Live (oder den Dev-Extension-Host) erneut.

Lizenz

MIT für den Code in diesem Repository. Die Tarballs in vendor/ (Ableton Extensions SDK & CLI) sind Eigentum von Ableton und fallen unter eine eigenen Lizenz (siehe sdk/LICENSE.md in der SDK-Distribution).