Ableton Live MCP

Un servidor MCP para Ableton Live 12, construido sobre el Ableton Extensions SDK oficial. El servidor MCP se ejecuta dentro de Live como una extensión: sin proceso puente, sin scripts MIDI de control remoto. Cualquier cliente MCP (Claude Code, Claude Desktop, Cursor, ...) se conecta a través de streamable HTTP y tiene el control programático total del Live Set: pistas, clips, notas MIDI, dispositivos, parámetros, mezclador, escenas, warp, renderizado y más.

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

Requisitos

• Ableton Live 12.4.5 o superior (compatible con Extensiones)

• Node.js >= 24.14 (solo de compilación)

Related MCP server: ableton-mind

Instalación

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

Después arrastra el archivo .ablx hasta Configuración → Extensiones en Live. El endpoint MCP se inicia con Live en http://127.0.0.1:8722/mcp (GET /health para una comprobación rápida).

Modo desarrollador

Activa Configuración → Extensiones → Modo de desarrollador en Live y a continuación:

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

El .env debe apuntar a tu instalación de Live, por ejemplo: EXTENSION_HOST_PATH=/Applications/Ableton Live 12 Beta.app.

Conectar un cliente

Claude Code:

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

Claude Desktop (o cualquier cliente que solo sea stdio) mediante mcp-remote:

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

Configuración

El puerto se guarda en config.json dentro del directorio de almacenamiento de la extensión (se crea en la primera ejecución; song_get notifica la ruta en environment.storage_directory). Por defecto:

{ "port": 8722 }

Cómo funciona

• Cada objeto de Live (pista, clip, groove, paramere, ...) se direcciona por un id de objeto estable descubierto mediante las herramientas de listado (song_get, track_id, device_get, ...).

• Los ids siguen siendo válidos hasta que el objeto se elimina o se mueve, o hasta que se carga otro conjunto, no Live Set. Los ids obsoletos devuelven un error que indica al cliente que vuelva a listar.

• Todos los tiempos/posiciones están en beats; versiones de colores son #RRGGBB; el diagrama MIDI es 0-127.

• Los escrituras con múltiples valores (parameter_set) se agrupan en un único paso de Deshacer en Live.

Herramientas

Canción

Pistas

Escenas y localizadores

Clips

Dispositivos y racks

Parámetros y mezclas

Archivos y renderizado

Interfaz y comandos

Habilidades

skills/ableton-live/SKILL.md es un skill de agente instalable que enseña a un cliente MCP a usar bien estas herramientas (flujo de descubrimiento de ids, beats frente a segundos, patrones de edición de notas, workflows de dispositivos). Instálalo en Claude Code con:

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

Cosas típicas que le puedes pedir a un asistente conectado, por ejemplo:

• "Crea un patrón house de 4 compases en una nueva pista MIDI con un Drum Rack."

• "Aplica warp a todos los clips de la pista Drums en modo Complex Pro."

• "Baja 3 dB a todas las pistas que no sean un bus vocal."

• "Construye un esqueleto de canción: intro, estrofas y estribillos, un localizador."

• "Reemplaza la muestra del Simpler por /path to kick.wav y mañanalo a C1."

Limitaciones

• La extensión (y por tanto el endpoint MCP) solo se ejecuta mientras Live está abierto.

• Solo se pueden insertar dispositivos integrados de Live; el SDK no puede cargar plugins de terceros.

• No hay control de transporte (play/stop/record) ni lanzamiento de clips — la Extensions API v1.0.0 no los expone. Tampoco expone el acceso al navegador ni las curvas de automatización de parámetros.

• show_dialog bloquea la ejecución hasta que el usuario cierra el diálogo en Live.

Pruebas

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

La prueba de humo en vivo crea sus propias pistas/clips/dispositivos, verifica todas las familias de herramientas (notas MIDI, warping, drum racks, renderizado, ...) y elimina todo lo que ha creado.

Particularidades del Extension Host (conviene saberlas)

Dos comportamientos de la versión beta del Extension Host que este proyecto sortea:

1. Contexto de VM mínimo. Las extensiones se evalúan en un contexto V8 sin global ni con las globales web (Request, Response, ReadableStream, fetch, EventTarget, ...), que el SDK de MCP necesita en el momento de la carga. build.ts inyecta un banner que los introduce desde el contexto principal de Node (las funciones de módulos core son compartidas, así que su constructor Function se evalúa allí). Consulta build.ts para más detalles.

2. Valores bigint. El host devuelve bigint para algunos valores que el SDK tipifica como number (colores de clips, alturas de las notas, ...). src/serialize.ts normaliza con num() antes de hacer aritmética o pasar a JSON.

3. Escrituras asíncronas. Los setters de propiedades del SDK (notas, nombres, valores) devuelven el control antes de que Live haya aplicado el cambio; una lectura en unas pocas decenas de milisegundos puede devolver el estado anterior. Los agentes apenas lo notan, pero las pruebas de lectura tras una escritura deben reintentar brevemente (ver eventually() en test/live-smoke.mjs).

También: si el Extension Host de desarrollo se cae, Live puede rechazar el siguiente handshake del canal de control ("bring-up timed out") — reinicia Live y ejecuta npm start de nuevo.

Solución de problemas

• El endpoint no responde: ejecuta curl http://127.0.0.1:8722/health. Haz clic derecho en cualquier pista de Live — la acción de menú contextual "Ableton Live MCP: Status" muestra el endpoint al que realmente se vinculó la extensión.

• El puerto ya está en uso: si otro proceso ocupa el puerto configurado, el servidor registra el fallo en ExtensionHost.txt y no se inicia. Cambia port en el config.json de la extensión (la ruta la muestra song_get en environment.storage_directory) — el archivo se lee una sola vez al inicio, así que reinicia Live después.

• Cambiaste config.json y no ha pasado nada: la configuración solo se lee al arrancar la extensión. Reinicia Live (o el Extension Host de desarrollo).

Licencia

MIT para el código de este repositorio. Los tarballs de vendor/ (Ableton Plugins SDK & CLI) pertenecen a Ableton y están cubiertos por su propia licencia (ver sdk/LICENSE.md en la distribución del SDK).