Ableton Control Deck

Ableton Control Deck es un puente MCP local para Ableton Live. Proporciona a cualquier cliente MCP — Claude Code, Claude Desktop, Codex, o cualquier otra cosa que hable MCP — un control exacto, verificado mediante relectura, de las pistas, clips, transporte, dispositivos y parámetros de plug-ins de terceros de Live, además de un panel de estado local.

Todo se ejecuta en tu máquina y solo se enlaza a direcciones de loopback. Nada se publica ni se expone a la red.

Ableton y Ableton Live son marcas comerciales de Ableton AG. Este proyecto es una herramienta comunitaria independiente y no está afiliado ni respaldado por Ableton.

Cómo funciona

• Un script remoto de Live (remote-script/Control_Deck/) se ejecuta como una superficie de control dentro de Ableton Live y escucha en el puerto UDP 50711 un protocolo de solicitud local autenticado. La API de Live que expone es una lista de permisos explícita, nunca un ejecutor genérico de métodos.

• El servidor MCP (src/index.ts, compilado en dist/) expone el control de Live como herramientas MCP y se comunica con el script remoto a través de un cliente UDP local sin dependencias (src/ableton-client.ts).

• Un secreto por instalación, generado por npm run setup y nunca confirmado, autentica cada solicitud entre ambos.

• Un servicio de estado de solo lectura (src/dashboard-server.mjs, puerto 50712) y un panel Next.js (dashboard/, puerto 50713) muestran la salud del puente, la sesión actual de Live, los dispositivos cargados y un inventario local buscable de plug-ins VST3, VST2, Audio Unit y CLAP.

• Un dispositivo opcional de Max for Live, Control Deck OmniHost (max-for-live/), aloja un instrumento VST3 directamente y expone su catálogo completo de parámetros publicado — miles de parámetros, mucho más allá del panel automático de dispositivos de Live — a través de su propio canal de loopback (UDP 50714).

• Un envoltorio nativo opcional para macOS (macos/) muestra el panel en una ventana WebKit bloqueada a la dirección local; la navegación externa está bloqueada.

• Un índice de muestras SQLite local opcional (src/sample-index.ts) hace que una unidad de muestras externa sea buscable por palabra clave, BPM, tonalidad y tipo one-shot/loop, sin escribir nunca en el audio fuente.

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

Reglas de diseño

• Las mutaciones de pistas y dispositivos requieren tanto el índice como el nombre actual exacto; los nombres obsoletos son rechazados.

• La carga de plug-ins se resuelve a través del índice del propio Navegador de Live y rechaza nombres ambiguos en lugar de adivinar.

• Las operaciones destructivas (delete_track, reconstrucciones de índice) requieren banderas de confirmación explícitas.

• Cada mutación va seguida de una consulta de relectura separada, y la herramienta informa el valor que Live realmente muestra.

• Los IDs de solicitudes completadas se almacenan en caché por el puente, por lo que una solicitud UDP duplicada nunca puede ejecutar una mutación dos veces.

Herramientas

• Estado, transporte, tempo, compás y posición de la canción con verificación de relectura

• Listar, crear, renombrar y eliminar pistas de forma segura

• Crear clips MIDI de Vista de Sesión y escribir contenido de notas validado

• Inspeccionar escenas, clips, selección, dispositivos y cada parámetro que Live expone

• Descubrir, resolver y cargar plug-ins VST3/VST2/AU en una pista exacta a través del Navegador de Live

• Cargar dispositivos nativos de Live (Drum Rack, Echo, Reverb, ...) por nombre exacto del Navegador con rechazo de ambigüedad

• Leer y establecer parámetros de plug-ins de terceros con valores normalizados y relectura

• Controlar un instrumento VST3 completamente indexado a través de OmniHost, más allá del límite de parámetros de Live

• Buscar un índice de muestras local por palabra clave, carpeta, BPM, tonalidad, duración y etiquetas

Requisitos

• macOS 13 Ventura o superior (Apple silicon e Intel) — macOS es la única plataforma compatible hoy en día. El núcleo es neutral en cuanto a plataforma y un puerto a Linux/Windows está bien delimitado; consulta PORTING.md.

• Ableton Live 11 o superior (objetivo probado: Live 12)

• Node.js 20+

• Max for Live (opcional — solo para el dispositivo OmniHost)

La documentación completa — descripciones de componentes, configuración de Live, la referencia completa de herramientas MCP, resolución de problemas y desinstalación — se encuentra en HELP.md.

Instalación

Inicio rápido (sin necesidad de programar)

1. Instala Node.js — descarga la versión LTS desde nodejs.org y ejecuta su instalador con las opciones predeterminadas. (Control Deck se ejecuta sobre él; nunca tendrás que tocarlo de nuevo.)

2. Descarga Control Deck — usa el botón verde Code → Download ZIP de GitHub, descomprímelo y mueve la carpeta a un lugar permanente, como tu carpeta personal. No lo dejes en Descargas — el instalador fija los servicios a la ubicación de la carpeta y te pedirá que la muevas.

3. Ejecuta el instalador — haz clic derecho en Install Ableton Control Deck.command y elige Abrir (macOS requiere el clic derecho la primera vez para archivos descargados). Instala todo, inicia los servicios en segundo plano y abre la guía de conexión cuando termine. Es seguro volver a ejecutarlo en cualquier momento.

4. Habilita la Superficie de Control en Live — Ajustes → Link, Tempo y MIDI → elige Control Deck en un espacio libre de Superficie de Control (reinicia Live primero si estaba abierto durante la configuración).

5. Conecta tu agente de IA — la guía que se abrió (http://127.0.0.1:50713/connect) tiene instrucciones de copiar y pegar para cada cliente.

Configuración para desarrolladores

npm run setup es el mismo motor que usa el instalador — instalación de dependencias, compilaciones de TypeScript + OmniHost + panel, secreto por instalación, instalación del script remoto y agentes launchd (escritos y activados). Es idempotente; vuelve a ejecutarlo después de obtener cambios o mover la copia de trabajo.

npm run setup

Indicadores para un ciclo más ajustado: --skip-build (sin instalaciones/compilaciones de npm), --skip-remote-script, --skip-agents. Las piezas granulares aún están disponibles como scripts individuales (build, build:omnihost, install:omnihost, index:plugins, samples:index y los propios dev/build/check del panel).

Lo que gestiona la configuración:

1. un secreto por instalación en data/bridge-token (compartido por el script remoto y los clientes; nunca confirmado),

2. el script remoto (con el secreto incrustado) en ~/Music/Ableton/User Library/Remote Scripts/Control_Deck/,

3. dos agentes launchd que apuntan a esta copia de trabajo: com.abletondeck.api y com.abletondeck.dashboard.

Luego añade el servidor MCP a tu cliente. Por ejemplo, para Claude Code:

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

En Live, abre Ajustes → Link, Tempo y MIDI y confirma que Control Deck está seleccionado como Superficie de Control.

Conexión de otros agentes

La página Conectar del panel (http://127.0.0.1:50713/connect) tiene guías de configuración para copiar y pegar — renderizadas con la ruta de instalación real de tu máquina — para Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Grok CLI, entornos LLM completamente locales (LM Studio, Ollama a través de mcphost) y cualquier otro cliente MCP, además de una discusión honesta sobre lo que se necesitaría (y el costo, en seguridad) para exponer el puente a conectores remotos como claude.ai. La versión corta: cualquier agente que pueda lanzar un servidor MCP stdio puede manejar Live; los conectores remotos en la nube están deliberadamente fuera del alcance.

Panel de Control Deck

Abre el panel en http://127.0.0.1:50713 (se inicia al inicio de sesión si activaste los agentes launchd). Muestra la salud del puente, la sesión actual de Live, la cadena de dispositivos de la pista seleccionada y un inventario local buscable de plug-ins instalados. Su página de configuración controla la conexión del puente, el comportamiento de actualización, los valores predeterminados de la biblioteca, la densidad, el color y el movimiento. Los cambios de proyecto siguen usando las herramientas MCP exactas y verificadas mediante relectura.

La aplicación nativa opcional se compila con npm run build:macos como Ableton Control Deck.app.

Comandos locales

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

El panel tiene su propia verificación de compilación:

cd dashboard
npm run check

Modelo de seguridad

• El puente escucha solo en 127.0.0.1 UDP 50711; el servicio de estado, el panel y OmniHost se enlazan solo a loopback.

• Cada solicitud al puente debe llevar el secreto por instalación de data/bridge-token. El script remoto se niega a iniciar si el secreto nunca fue incrustado.

• La superficie de la API de Live es una lista de permisos explícita con salvaguardas de objetivo exacto, por lo que un agente confundido falla ruidosamente en lugar de editar lo incorrecto.

• El servidor MCP registra las solicitudes localmente en logs/control-deck.jsonl para que puedas auditar lo que hizo un agente.

Licencia

MIT