Skip to main content
Glama
enesjakozh

REAPER MCP Server

by itsuzef
GitHub
Python
10
  • 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

              • ScrapeGraph MCP Serverofficial

                ScrapeGraphAI
                A
                security
                A
                license
                A
                quality
                A production-ready Model Context Protocol server that enables language models to leverage AI-powered web scraping capabilities, offering tools for transforming webpages to markdown, extracting structured data, and executing AI-powered web searches.
                Last updated -
                3
                34
                Python
                MIT License
                • Apple

              • Crawlab MCP Serverofficial

                crawlab-team
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that allows AI applications to interact with Crawlab's functionality through natural language, enabling spider management, task execution, and file operations.
                Last updated -
                4
                Python

              • Ableton Copilot MCP

                xiaolaa2
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables real-time interaction with Ableton Live, allowing AI assistants to control song creation, track management, clip operations, and audio recording workflows.
                Last updated -
                23
                11
                33
                TypeScript
                MIT License
                • Linux
                • Apple

              • DBeaver MCP Server

                srthkdev
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to access and query 200+ database types through existing DBeaver connections without additional configuration.
                Last updated -
                6
                TypeScript
                MIT License
                • Apple
                • Linux

              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