Reaper Daemon

Reaper Daemon

Reaper Daemon es un servidor MCP de REAPER y un puente de archivos para controlar REAPER desde un agente de IA, incluyendo la mezcla de tu sesión con Claude o cualquier otro agente. Sin socket de red, sin puerto, sin extensiones.

El agente deja un archivo de comandos JSON en una carpeta. Un script Lua dentro de REAPER lo ejecuta y escribe un resultado JSON de vuelta. Ese es todo el protocolo. Funciona con Claude Code, Codex, Cursor, o cualquier otra cosa que pueda leer y escribir archivos, y un servidor MCP stdio opcional, reaper_mcp.py, expone el mismo puente como herramientas para Claude Desktop y cualquier otro cliente MCP.

macOS, Windows, Linux. Lua puro dentro de REAPER, Python 3 simple fuera, sin paquetes pip. Cada cambio se ejecuta dentro de un bloque de deshacer de REAPER, así que Ctrl+Z revierte cualquier cosa que haga un agente.

Instalación

git clone https://github.com/wretcher207/reaper-daemon.git
cd reaper-daemon
python3 setup/install.py

Reinicia REAPER y luego verifica que el puente esté activo:

python3 reaperd.py status

¿Prefieres ReaPack, o quieres cargar el puente manualmente? Consulta docs/install.md.

Mezcla con un agente de IA

Apunta a Claude, o a cualquier agente que hable con Reaper Daemon, a tu sesión abierta de REAPER y pídele que trabaje en la mezcla. Lee cada plugin y parámetro con scan_fx, establece valores de FX en unidades reales como "-2.5 dB", y escribe automatización. verify_change captura la pista antes y después de un movimiento y reporta qué cambió en el audio, para que no te fíes solo de su palabra. Cada movimiento está dentro de un bloque de deshacer de REAPER, y tus oídos toman la decisión.

Ejemplos de indicaciones:

• "El bajo está embarrado alrededor de 300 Hz, bájalo."
• "Baja la voz para que se asiente con la mezcla en lugar de encima."
• "Ajusta el bajo hasta que su LUFS baje 3 dB."
• "¿Qué plugins hay en el bus de batería y cómo están configurados?"

Consulta Servidor MCP para la configuración y Verificar para qué demuestran y qué no demuestran las mediciones.

Qué hace

Área	Comandos
Proyecto	transporte, tempo, cursor, selección de tiempo, render, guardar
Pistas	añadir, eliminar, renombrar, seleccionar, volumen, paneo, silenciar, solo, armar, color
Enrutamiento	leer envíos y recepciones, crear envíos, alternar alimentación al master
FX	añadir, eliminar, bypass, reordenar, establecer parámetros, escribir automatización, guardar cadenas
Marcadores, regiones, elementos de medios	lectura y escritura completa
MIDI	insertar archivos MIDI, más un DSL de batería con humanización
Guitarra y bajo	shred renderiza un riff humanizado, band corta una sección rítmica completa
Descubrimiento	scan_fx vuelca cada plugin y parámetro; discover_drum_map lee el mapa de notas de cualquier kit
Verificar	medir sonoridad, espectro y dinámica antes y después de un movimiento de mezcla

El puente no sabe nada sobre ningún plugin o librería de batería específica. Los agentes descubren qué contiene un proyecto y actúan sobre ello por nombre.

Tres formas de hablar con él

CLI. Un punto de entrada de Python para todo lo que hace un agente.

python3 reaperd.py send commands/examples/get_context.json --wait
python3 reaperd.py shred --track argent-l --bars-file riff.txt --seed 101

Servidor MCP. reaper_mcp.py envuelve el puente como herramientas sobre stdio. Pídele a Claude Desktop "medir la batería" y lo hace.

Consola Daemon. Un panel de chat acoplado dentro de REAPER, respaldado por una sesión headless de Claude Code que siempre sabe qué pista tienes seleccionada.

Documentación

Instalación	instalador de una línea, ReaPack, carga manual
CLI	referencia de reaperd.py
Servidor MCP	configuración para Claude Desktop y otros clientes
Consola Daemon	el panel de chat dentro de REAPER
Batería	descubrimiento de kits, perfilado de stems, humanizar
Guitarra y bajo	shred y band
Recetas de mezcla	capturar, comparar y reconstruir una configuración de mezcla
Verificar	movimientos de mezcla de bucle cerrado con prueba medida
Protocolo	el formato de archivo por cable
Solución de problemas	capturas silenciosas, latidos obsoletos
Seguridad	modelo de confianza y el token opcional
Desarrollar	pruebas, CI, estructura del repositorio

Los agentes deberían leer AGENTS.md, CLAUDE.md, y bridge/command_schema.md. Dos habilidades incluidas, arrangement-midi y drum-humanize, cubren composición MIDI y humanización de batería.

Seguridad

Cualquier proceso que pueda escribir en inbox/ puede controlar REAPER. Mantén la carpeta del puente local y fuera de unidades compartidas. Detalles en docs/security.md.

Licencia

MIT. Consulta LICENSE.

La configuración de rendimiento del teclado, las pruebas de MIDI/controlador y el guardado de plantillas están documentados en el flujo de trabajo de rendimiento.