Ableton Copilot MCP

Ableton Copilot MCP

Un servidor MCP (Model Context Protocol) creado en ableton-js para la interacción y el control en tiempo real con Ableton Live, dedicado a ayudar a los productores musicales en su producción musical.

🎯 Nota

Como productor musical, tengo conocimientos sobre el uso de Ableton para la creación musical. Durante el proceso creativo, a menudo necesitamos gestionar diversas operaciones tediosas, como humanizar las propiedades de las notas, fusionarlas, grabar una pista en otra, etc. Antes, solo podíamos confiar en las funciones del DAW anfitrión para estas operaciones. Sin embargo, con la aparición de grandes modelos de lenguaje y MCP, ahora podemos permitir que la IA nos ayude con la automatización. Aunque todavía no es realista que la IA genere notas directamente ni cree una canción completa (no puede generar una canción con buen sonido), contar con la asistencia de la IA en operaciones auxiliares presenta una nueva posibilidad.

🚀 Características

🎵 Control de canciones

• Obtenga información básica de la canción (nota raíz, nombre de la escala, tempo, duración de la canción, etc.)
• Obtener una lista de todas las pistas
• Crear pistas MIDI, de audio y de retorno
• Eliminar y duplicar pistas

🎹 Gestión de pistas

• Obtener todos los clips en una pista
• Crear clips MIDI vacíos en las pistas de la vista de arreglo
• Cree clips de audio en pistas según las rutas de archivos de muestra proporcionadas
• Establecer propiedades de pista (silencio, color, nombre, armado, solo, etc.)
• Duplicar clips MIDI en pistas específicas

Operaciones de clip

• Obtener clips en la vista de rollo de piano
• Obtener y administrar todas las notas en un clip
• Agregar, eliminar y reemplazar notas en clips
• Establecer propiedades del clip (nombre, color, bucle, inicio_bucle, fin_bucle, etc.)

Operaciones de audio

• Admite la grabación de contenido de pista según un rango de tiempo

🔌 Administración de dispositivos

• Cargar efectos de audio, instrumentos y complementos
• Modificar los parámetros del dispositivo
• Explorar los dispositivos disponibles en la biblioteca

📝 Gestión Estatal

• Seguimiento del historial de operaciones y registro detallado
• Creación de instantáneas para operaciones críticas
• Soporte para reversión de operaciones (especialmente para operaciones de notas)
• Explorar y restaurar estados anteriores

📝 Lista de tareas pendientes

• Permitir devolver el clip_id creado al crear clips midi (pendiente de actualización de ableton-js)
• Admite ajuste automático de envolvente
• Admite más tipos de instantáneas (propiedades de pista, parámetros del dispositivo, etc.)

⚠️ Advertencia

• La manipulación directa de clips MIDI por parte de la IA puede provocar la pérdida de las notas originales y no se puede deshacer con Ctrl + Z. Tenga cuidado. Si es necesario, puede solicitar a la IA que le ayude a revertir las operaciones de notas.

📥 Instalación

Prerrequisitos

• Entorno Node.js : asegúrese de que Node.js esté instalado (se recomienda v20+) y que el comando npx esté disponible

  🔗 Descargar: Sitio web oficial de Node.js

Pasos de instalación

1. Instalar scripts remotos MIDI de AbletonJS

Elija UNO de los siguientes tres métodos para instalar scripts remotos MIDI:

• Método 1: Instalación en una sola línea (recomendado)
  npx @xiaolaa2/ableton-copilot-mcp --install-scripts # or use the short form npx @xiaolaa2/ableton-copilot-mcp -is
• Método 2: Instalación asistida por herramientas
  1. Primero, inicie ableton-copilot-mcp (consulte la sección Uso a continuación)
  2. Deje que el asistente de IA o llame manualmente a la herramienta MCP init_ableton_js para completar la instalación automáticamente
• Método 3: Instalación manual
  1. Cree una carpeta llamada "Scripts remotos" en su biblioteca de usuario de Ableton:
     • Windows: C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts
     • Mac: /Users/[username]/Music/Ableton/User Library\Remote Scripts
  2. Descargar scripts remotos MIDI desde el proyecto ableton-js
  3. Copie la carpeta midi-script descargada a la ubicación anterior
  4. Cámbiale el nombre a AbletonJS

🔧 Uso

Inicio rápido

1. Iniciar Ableton Live
2. Habilitar la superficie de control de AbletonJS
   • Abra las preferencias de Ableton Live: Preferences → Link/MIDI
   • En la pestaña MIDI , localice la sección Control Surface
   • Seleccione AbletonJS en el menú desplegable
3. Conectarse mediante un cliente MCPLos siguientes clientes se pueden utilizar como puntos finales de MCP:
   • Cursor
   • Estudio Cherry
   • Escritorio de Claude
   • Otros clientes de MCP

Configuración del cliente

Ejemplo de configuración del cursor

Agregue la siguiente configuración a la configuración del cursor:

Para la última versión:

Ruta de almacenamiento personalizada (opcional)

Puede especificar una ubicación de almacenamiento de datos personalizada utilizando la variable de entorno BASE_PATH :

💡 Consejo : La ruta de almacenamiento se utiliza para guardar archivos de registro, historial de operaciones e instantáneas de estado.

Consejos de uso

• Al conectarse por primera vez, puede tomar unos segundos establecer comunicación con Ableton Live
• Asegúrese de que Ableton Live se esté ejecutando y que la superficie de control de AbletonJS esté cargada correctamente
• Para comprobar el estado de la conexión, puede utilizar el comando get_song_status en las herramientas de MCP

✅ Pruebas de compatibilidad

La compatibilidad depende principalmente de la versión compatible con la biblioteca ableton-js .

🤝 Contribuyendo

Se agradecen los problemas y las contribuciones. Envíe sus problemas o sugerencias a través de GitHub Issues .

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT .

⚠️ Descargo de responsabilidad

Esta es una integración de terceros y no realizada por Ableton.