Ableton MCP Extended

Controla Ableton Live usando lenguaje natural a través de asistentes de IA como Claude o Cursor. Este proyecto proporciona un servidor robusto de Protocolo de Contexto de Modelo (MCP) que traduce comandos en lenguaje natural en acciones precisas dentro de tu sesión de Ableton Live.

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 desean 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 sobre el entorno de Ableton Live.

• Control de sesión y transporte:

  • Iniciar y detener la reproducción.

  • Obtener información de la sesión, incluyendo 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, panorama, mute, solo y armar.

  • Gestionar la 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 bucle de clip y acciones de seguimiento (follow actions).

• 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 por lotes parámetros de dispositivos 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 de navegador o URI.

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

• Generación de voz y audio

  • Integración de texto a voz: Genera narración, muestras vocales o elementos hablados a través de ElevenLabs MCP [incluido].

  • Creación de voz personalizada: 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 instantáneamente en tu sesión de Ableton.

• Marco extensible para herramientas personalizadas

  • Ejemplo: Controlador de ratón XY: Demuestra la creación de controladores personalizados de Ableton con el marco MCP.

  • Latencia ultra baja: El protocolo UDP de alto rendimiento permite un control en tiempo real y con gran capacidad de respuesta.

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

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. Encuentra tu carpeta de Remote Scripts de Ableton:

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

   • Mac: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/

2. Crea la carpeta: AbletonMCP

3. Copia AbletonMCP_Remote_Script/__init__.py dentro de esta carpeta.

3. Configura Ableton

1. Abre Ableton Live.

2. Ve a Preferencias → Link, Tempo & MIDI.

3. Establece Control Surface en "AbletonMCP".

4. Establece Input/Output 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 Settings → MCP con la misma ruta.

5. ¡Empieza a crear!

Abre tu asistente de IA y prueba:

• "Create a new MIDI track with a piano"

• "Add a simple drum beat"

• "What tracks do I currently have?"

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. Envías un comando en inglés sencillo a tu asistente de IA (ej. "Create a new MIDI track and name it 'Bass'").

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

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

4. El script remoto de Ableton (init.py), ejecutándose dentro de Live, recibe el comando JSON a través de una conexión de socket.

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

Características avanzadas

Para un control de parámetros en tiempo real con latencia ultra baja:

# 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 puede integrarse con otros servidores MCP, como uno para ElevenLabs, para generar e importar audio directamente a tu proyecto.

Configura el servidor MCP de ElevenLabs siguiendo 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 central

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

• Integración extensa 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 ultra baja para interpretaciones 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 a 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

• GitHub Issues: 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

¿Qué sigue?

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

• ~~Soporte para plugins VST - Controla plugins de terceros [Aunque se puede lograr a través de la función de parámetro "Configure"]~~ → ¡Hecho!

• Vista de arreglo - Control total de la línea de tiempo.

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

• IA avanzada - Comprensión y generación musical más inteligente y mejor.

Licencia y créditos

Este proyecto tiene licencia 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 en: 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!