Ableton MCP Extended

Controla Ableton Live usando lenguaje natural mediante asistentes de IA como Claude o Cursor. Este proyecto proporciona un servidor robusto de Model Context Protocol (MCP) que traduce comandos en lenguaje natural en acciones precisas dentro de tu sesión de Ableton Live.

Fork con mejoras. Se han añadido 22 comandos Remote Script y 25 herramientas MCP: lectura de notas MIDI, escenas, propiedades de clips de sesión, mezclador (mute/solo/arm, envíos), matriz de modulación Wavetable, undo/redo. Detalles e instalación — en FORK-NOTES.md.

Video de demostración: https://www.youtube.com/watch?v=7ZKPIrJuuKk

Esta herramienta está diseñada para productores, desarrolladores y entusiastas de la IA que quieran optimizar su flujo de trabajo de producción musical, experimentar con música generativa y crear integraciones personalizadas con Ableton Live.

Puedes transformar esta conversación:

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

En esta sesión de producción musical:

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3

Características principales

Este proyecto proporciona un control integral y programático del entorno de Ableton Live.

• Control de sesión y transporte:

  • Iniciar y detener la reproducción.

  • Obtener información de la sesión, incluidos tempo, compás y número de pistas.

  • Gestionar escenas: crear, eliminar, renombrar y disparar.

• Gestión de pistas:

  • Crear, renombrar y obtener información detallada de pistas MIDI y de audio.

  • Controlar propiedades de pista: volumen, panorámica, mute, solo y arm.

  • Gestionar agrupación de pistas y estados de plegado.

• Manipulación de clips MIDI y notas:

  • Crear y nombrar clips MIDI con longitudes especificadas.

  • Añadir, eliminar, transponer y cuantizar notas dentro de los clips.

  • Realizar ediciones por lotes en múltiples notas en una sola operación.

  • Ajustar parámetros de loop del clip y acciones de seguimiento.

• Control de dispositivos y parámetros:

  • Cargar instrumentos y efectos desde el navegador de Ableton mediante URI.

  • Obtener una lista completa de parámetros para cualquier dispositivo en una pista.

  • Establecer y establecer en lote parámetros de dispositivo usando valores normalizados (0.0 a 1.0).

• Automatización y envolventes:

  • Añadir y borrar puntos de automatización para cualquier parámetro de dispositivo dentro de un clip. [Esta función aún no funciona perfectamente.]

  • Obtener información sobre las envolventes de clip existentes.

• Integración con el navegador:

  • Navegar y listar elementos del navegador de Ableton.

  • Cargar instrumentos, efectos y muestras directamente desde una ruta del navegador o URI.

  • Importar archivos de audio directamente en pistas de audio o ranuras de clip.

• Generación de voz y audio:

  • Integración de texto a voz: genera narraciones, muestras vocales o elementos hablados mediante ElevenLabs MCP [incluido].

  • Creación de voces personalizadas: clona voces para dar un carácter único a tus pistas.

  • Efectos de sonido: crea SFX personalizados con IA.

  • Importación directa: el audio generado aparece al instante en tu sesión de Ableton.

• Marco extensible para herramientas personalizadas:

  • Ejemplo: Controlador de ratón XY: demuestra cómo crear controladores personalizados de Ableton con el marco MCP.

  • Latencia ultrabaja: el protocolo UDP de alto rendimiento permite un control en tiempo real receptivo.

  • Posibilidades ilimitadas: crea tus propias herramientas y controladores personalizados para Ableton Live.

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

Inicio rápido (5 minutos)

Requisitos previos

• Ableton Live 11+ (cualquier edición)

• Python 3.10 o superior

• Claude Desktop o Cursor IDE

1. Obtén el código

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. Instala el script de Ableton

1. Busca la carpeta de Remote Scripts de tu Biblioteca de Usuario de Ableton:

   • Windows: C:\Users\[Tú]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Music/Ableton/User Library/Remote Scripts/

2. Crea la carpeta: AbletonMCP

3. Copia AbletonMCP_Remote_Script/__init__.py en esta carpeta

3. Configura Ableton

1. Abre Ableton Live

2. Ve a Preferencias → Link, Tempo & MIDI

3. Establece Superficie de control en "AbletonMCP"

4. Establece Entrada/Salida en "None"

4. Conecta el asistente de IA

Para Claude Desktop:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

Para Cursor: Añade el servidor MCP en Configuración → MCP con la misma ruta.

5. ¡Empieza a crear!

Abre tu asistente de IA y prueba:

• "Crea una nueva pista MIDI con un piano"

• "Añade un ritmo de batería simple"

• "¿Qué pistas tengo actualmente?"

Cómo funciona

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C

1. Emites un comando en inglés sencillo a tu asistente de IA (por ejemplo, "Crea una nueva pista MIDI y nómbrala 'Bass'").

2. El asistente de IA entiende la intención y llama a la herramienta adecuada del servidor MCP.

3. El servidor MCP (server.py) recibe la llamada a la herramienta y construye un comando JSON específico.

4. El Remote Script de Ableton (init.py), que se ejecuta dentro de Live, recibe el comando JSON a través de una conexión de socket.

5. El Remote Script ejecuta el comando usando la API oficial de Ableton Live, realizando el cambio en tu sesión al instante.

Características avanzadas

Para control de parámetros en tiempo real con latencia ultrabaja:

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

Esto demuestra cómo construir:

• Controladores personalizados en tiempo real para Ableton

• Herramientas de interpretación expresivas

• Aplicaciones musicales interactivas

Este repositorio se puede integrar con otros servidores MCP, como uno para ElevenLabs, para generar e importar audio directamente en tu proyecto.

Configura el servidor MCP de ElevenLabs según sus instrucciones.

Actualiza la configuración de tu asistente de IA para incluir ambos servidores.

Ejemplo de mcp-config.json:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Resumen de componentes

Este proyecto incluye varios componentes especializados:

Servidor MCP principal

• Comunicación TCP estándar para un control fiable de la IA

• Amplia integración con la API de Ableton Live

• Compatible con Claude Desktop, Cursor y Gemini CLI.

Servidor híbrido TCP/UDP

• Control de parámetros en tiempo real de alto rendimiento

• Latencia ultrabaja para actuaciones en vivo

• Perfecto para controladores y herramientas interactivas

Integración con ElevenLabs

• Generación profesional de texto a voz

• Creación y clonación de voces personalizadas

• Importación directa en sesiones de Ableton

• Generación de SFX en tiempo real

Herramientas experimentales y ejemplos

• Controlador de ratón XY: ejemplo que demuestra cómo construir controladores personalizados de Ableton

• Marco extensible: base para crear tus propias interfaces de control

• Prueba de concepto: muestra el poder y la flexibilidad del enfoque MCP

Documentación

• Guía de instalación - Instrucciones detalladas de configuración

• Guía de usuario - Qué, cuál y cómo

Comunidad y soporte

• Issues de GitHub: informes de errores y solicitudes de funciones

• Discusiones: comparte tus creaciones y obtén ayuda

Comparte tus creaciones

¡Etiquétame con tus experimentos generados por IA! Me encanta ver lo que crea la comunidad:

YouTube | Instagram | Patreon | Sitio web

Lo que viene después

• Corregir errores de colocación de puntos de automatización

• Soporte de plugins VST - Controlar plugins de terceros [Aunque se puede lograr mediante la función de parámetro "Configure"] → ¡Hecho!

• Vista de arreglo - Control completo de la línea de tiempo

• Integración de hardware - Puente de controladores MIDI a través de IA

• IA avanzada - Mejor y más inteligente comprensión y generación musical

Licencia y créditos

Este proyecto está licenciado bajo la Licencia MIT - consulta LICENSE para más detalles.

Construido con:

• Model Context Protocol - Marco de integración de IA

• ElevenLabs API - Generación de voz profesional

• Ableton Live - Estación de trabajo de audio digital

Inspirado por: El proyecto original ableton-mcp

Hecho con ❤️ para la comunidad de producción musical

Si este proyecto ayuda a tu creatividad, ¡considera darle una ⭐ estrella!