Skip to main content
Glama
enesjakozh

REAPER MCP Server

by itsuzef
GitHub
Python
37
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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

# Clone the repository git clone https://github.com/itsuzef/reaper-mcp.git cd reaper-mcp # Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install the package pip install -e .

Uso

Inicio rápido

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

# Start REAPER first open /Applications/REAPER.app # On macOS # or start REAPER manually on other platforms # Then start the MCP server ./scripts/start_reaper_mcp_server.sh # On Unix/Mac
Usuarios de Windows

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

# Using Command Prompt (CMD) scripts\start_reaper_mcp_server.bat # Using PowerShell powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1

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:

# Start in OSC mode (default) ./scripts/start_reaper_mcp_server.sh --mode=osc # Unix/Mac scripts\start_reaper_mcp_server.bat --mode=osc # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -mode osc # Windows PowerShell # Start in ReaScript mode ./scripts/start_reaper_mcp_server.sh --mode=reapy # Unix/Mac scripts\start_reaper_mcp_server.bat --mode=reapy # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -mode reapy # Windows PowerShell # Configure OSC settings (Unix/Mac) ./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000 # Configure OSC settings (Windows CMD) scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000 # Configure OSC settings (Windows PowerShell) powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000 # Enable debug logging ./scripts/start_reaper_mcp_server.sh --debug # Unix/Mac scripts\start_reaper_mcp_server.bat --debug # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -debug # Windows PowerShell

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:

./scripts/start_reaper_mcp_server.sh --mode=osc

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)

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Un servidor de protocolo de contexto de modelo que permite a los agentes de IA crear pistas completamente mezcladas y masterizadas en REAPER DAW, lo que admite la gestión de proyectos, la composición MIDI, la grabación de audio y la automatización de la mezcla.

  1. Características
    1. Requisitos
      1. Instalación
        1. Uso
          1. Inicio rápido
          2. Configuración
          3. Configuración de REAPER para OSC
          4. Configuración de REAPER para ReaScript
        2. Estructura del proyecto
          1. Herramientas MCP
            1. Solución de problemas
              1. Problemas con la API de ReaScript
              2. Problemas de comunicación de la OSC
              3. Solución de problemas específicos de Windows
            2. Licencia

              Related MCP Servers

              • Workato MCP Server

                jacobgoren-sb
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
                Last updated -
                TypeScript
                MIT License
                • Apple
                • Linux

              • Godot MCP

                Coding-Solo
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to interact with the Godot game engine, allowing them to launch the editor, run projects, capture debug output, and control project execution.
                Last updated -
                62
                JavaScript
                MIT License

              • Role-Specific Context MCP Server

                Chris-June
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables role-based context management for AI agents, allowing users to establish specific instructions, maintain partitioned memory, and adapt tone for different agent roles in their system.
                Last updated -
                TypeScript

              • DaVinci Resolve MCP Server

                Tooflex
                -
                security
                -
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants like Claude to interact with DaVinci Resolve Studio, providing advanced control over editing, color grading, audio, and other video production tasks.
                Last updated -
                Python

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/itsuzef/reaper-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server