Servidor REAPER MCP

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que permite a los agentes de IA crear pistas totalmente mezcladas y masterizadas en REAPER con capacidades de audio y MIDI.

Características

• Gestión completa del proyecto (creación, guardado, renderizado)

• Operaciones de seguimiento (creación, enrutamiento, ajuste de parámetros)

• Composición y edición MIDI

• Grabación e importación de audio

• Gestión de instrumentos y efectos virtuales

• Mezcla y automatización

• Dominando herramientas

• Análisis y retroalimentación de audio

Related MCP server: Ableton Copilot MCP

Requisitos

• REAPER DAW instalado

• Python 3.8+

• Soporte OSC habilitado en REAPER (para modo OSC)

• API de ReaScript habilitada en REAPER (para el modo ReaScript)

Instalación

Uso

Inicio rápido

La forma más fácil de comenzar es utilizar el script de inicio proporcionado:

Usuarios de Windows

Para los usuarios de Windows, utilice uno de los scripts de Windows proporcionados:

Configuración

De forma predeterminada, el servidor usará el modo OSC, que es más fiable y no requiere que la API de ReaScript funcione correctamente. Puede configurar el servidor mediante argumentos de la línea de comandos:

Configuración de REAPER para OSC

1. Abrir REAPER

2. Vaya a Preferencias > Control/OSC/web

3. Haga clic en "Agregar" y seleccione "OSC (Open Sound Control)"

4. Configure los siguientes ajustes:

   • Nombre del dispositivo: ReaperMCP

   • Modo: Puerto local

   • Puerto de escucha local: 8000

   • IP local: 127.0.0.1 (o la dirección IP de su computadora)

   • Permitir vincular mensajes a acciones REAPER y aprendizaje de FX: Marcado (opcional)

   • Tamaño máximo de paquete saliente: 1024

   • Espera entre paquetes: 10ms

Configuración de REAPER para ReaScript

1. Abrir REAPER

2. Vaya a Preferencias > Complementos > ReaScript

3. Asegúrese de que la opción "Habilitar Python para ReaScript" esté marcada

4. Establezca la ruta de la DLL/dylib de Python en su instalación de Python

   • En macOS: /opt/homebrew/Cellar/python@3.x/3.xx/Frameworks/Python.framework/Versions/3.x/Python

   • En Windows: C:\Path\to\Python\python3x.dll

5. Ejecute el script de configuración:

   python scripts/setup_reaper_python.py

Estructura del proyecto

• src/reaper_mcp/ : Directorio principal del paquete

  • __main__.py : Interfaz de línea de comandos

  • osc_server.py : implementación de servidor basada en OSC

  • server.py : implementación de servidor basada en ReaScript

• examples/ : Scripts de ejemplo que demuestran el uso

• scripts/ : Scripts de utilidad para configuración y ejecución

Herramientas MCP

El servidor proporciona las siguientes herramientas MCP:

• create_project : Crea un nuevo proyecto REAPER

• create_track : Crea una nueva pista en el proyecto actual

• list_tracks : enumera todas las pistas del proyecto actual

• add_midi_note : Agrega una nota MIDI a una pista

• get_project_info : Obtiene información sobre el proyecto actual

Solución de problemas

Problemas con la API de ReaScript

Si tiene problemas con la API de ReaScript, intente utilizar el modo OSC en su lugar:

Problemas de comunicación de la OSC

Asegúrese de que REAPER esté configurado correctamente para OSC:

1. Compruebe que la configuración OSC en REAPER coincida con la configuración del servidor

2. Verifique que ningún firewall esté bloqueando la comunicación

3. Intente utilizar la dirección IP local (127.0.0.1) en lugar de una IP de red

Solución de problemas específicos de Windows

Si tiene problemas al ejecutar el servidor MCP en Windows:

1. Problemas de ejecución de scripts :

   • Para los scripts de PowerShell, es posible que deba ajustar la política de ejecución: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

   • Alternativamente, utilice el indicador -ExecutionPolicy Bypass como se muestra en los ejemplos

2. Problemas de ruta :

   • Asegúrese de que la ruta REAPER en los scripts coincida con su ubicación de instalación

   • El valor predeterminado es C:\Program Files\REAPER\reaper.exe , modifíquelo si es necesario

3. Entorno virtual :

   • Si creó el venv con un método diferente, el script de activación podría estar en una ubicación diferente

   • Intente activarlo manualmente antes de ejecutar: venv\Scripts\activate

4. Bloqueo de firewall :

   • El Firewall de Windows puede bloquear la comunicación OSC

   • Agregar excepciones para Python y REAPER en la configuración del Firewall de Windows

5. Derechos de administrador :

   • Intente ejecutar el Símbolo del sistema o PowerShell como administrador si encuentra problemas de permisos

Licencia

Instituto Tecnológico de Massachusetts (MIT)