Reaper Daemon

Reaper Daemon

Reaper Daemon é um servidor MCP e ponte de arquivos para REAPER, que permite controlar o REAPER a partir de um agente de IA, incluindo mixar sua sessão com Claude ou qualquer outro agente. Sem socket de rede, sem porta, sem extensões.

O agente coloca um arquivo de comando JSON em uma pasta. Um script Lua dentro do REAPER o executa e grava um resultado JSON de volta. Esse é todo o protocolo. Funciona com Claude Code, Codex, Cursor ou qualquer outra ferramenta que possa ler e escrever arquivos, e um servidor MCP stdio opcional, reaper_mcp.py, expõe a mesma ponte como ferramentas para Claude Desktop e qualquer outro cliente MCP.

macOS, Windows, Linux. Lua puro dentro do REAPER, Python 3 simples fora, sem pacotes pip. Cada alteração é executada dentro de um bloco de desfazer do REAPER, então Ctrl+Z reverte qualquer ação do agente.

Instalação

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

Reinicie o REAPER e verifique se a ponte está ativa:

python3 reaperd.py status

Prefere ReaPack ou quer carregar a ponte manualmente? Veja docs/install.md.

Misture com um agente de IA

Aponte o Claude, ou qualquer agente que fale com o Reaper Daemon, para sua sessão aberta do REAPER e peça para trabalhar na mixagem. Ele lê todos os plugins e parâmetros com scan_fx, define valores de FX em unidades reais como "-2.5 dB" e escreve automação. verify_change captura a faixa antes e depois de um movimento e relata o que mudou no áudio, para que você não confie apenas na palavra dele. Cada movimento fica dentro de um bloco de desfazer do REAPER, e seus ouvidos decidem.

Exemplos de prompts:

• "O baixo está turvo em torno de 300 Hz, reduza."
• "Abaixe o vocal para que ele se assente com a mixagem em vez de ficar por cima."
• "Ajuste o baixo até que o LUFS caia 3 dB."
• "Quais plugins estão no barramento de bateria e como estão configurados?"

Veja servidor MCP para configuração e Verificar para saber o que as medições provam ou não.

O que ele faz

Área	Comandos
Projeto	transporte, tempo, cursor, seleção de tempo, render, salvar
Faixas	adicionar, excluir, renomear, selecionar, volume, pan, mudo, solo, armar, cor
Roteamento	ler sends e receives, criar sends, alternar alimentação do master
FX	adicionar, remover, bypass, reordenar, definir parâmetros, escrever automação, salvar chains
Marcadores, regiões, itens de mídia	leitura e escrita completas
MIDI	inserir arquivos MIDI, além de um DSL de bateria com humanização
Guitarra e baixo	shred renderiza um riff humanizado, band corta uma seção rítmica inteira
Descoberta	scan_fx despeja todos os plugins e parâmetros; discover_drum_map lê o mapa de notas de qualquer kit
Verificar	medir loudness, espectro e dinâmica antes e depois de um movimento de mixagem

A ponte não conhece nenhum plugin ou biblioteca de bateria específica. Os agentes descobrem o que um projeto contém e agem sobre ele pelo nome.

Três maneiras de falar com ele

CLI. Um ponto de entrada Python para tudo o que um agente faz.

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 envolve a ponte como ferramentas via stdio. Peça ao Claude Desktop para "medir a bateria" e ele faz.

Console Daemon. Um painel de chat encaixado dentro do REAPER, apoiado por uma sessão headless do Claude Code que sempre sabe qual faixa você selecionou.

Documentação

Instalação	instalador de uma linha, ReaPack, carregamento manual
CLI	referência de reaperd.py
Servidor MCP	configuração para Claude Desktop e outros clientes
Console Daemon	o painel de chat dentro do REAPER
Bateria	descoberta de kits, perfil de stems, humanização
Guitarra e baixo	shred e band
Receitas de mixagem	capturar, comparar e reconstruir uma configuração de mixagem
Verificar	movimentos de mixagem em loop fechado com prova medida
Protocolo	o formato de arquivo do wire
Solução de problemas	capturas silenciosas, heartbeats obsoletos
Segurança	modelo de confiança e o token opcional
Desenvolver	testes, CI, estrutura do repositório

Os agentes devem ler AGENTS.md, CLAUDE.md e bridge/command_schema.md. Duas habilidades incluídas, arrangement-midi e drum-humanize, cobrem composição MIDI e humanização de bateria.

Segurança

Qualquer processo que possa gravar em inbox/ pode controlar o REAPER. Mantenha a pasta da ponte local e fora de unidades compartilhadas. Detalhes em docs/security.md.

Licença

MIT. Veja LICENSE.

A configuração de performance de teclado, testes de MIDI/controlador e salvamento de templates estão documentados em o fluxo de trabalho de performance.