Reaper Daemon

Reaper Daemon

Reaper Daemon 是一个 REAPER MCP 服务和文件桥接工具，可让 AI Agent 驱动 REAPER， 包括使用 Claude 或任何其他 Agent 混音。 无需网络套接字、端口或扩展。

Agent 会将 JSON 命令文件放入文件夹中。REAPER 内部的 Lua 脚本会运行该文件并写回 JSON 结果。这就是全部协议。它适用于 Claude Code、Codex、Cursor，或任何能够读写文件的工具；此外，可选的 stdio MCP 服务 reaper_mcp.py 会将同一桥接功能作为工具提供给 Claude Desktop 和任何其他 MCP 客户端。

macOS、Windows、Linux 均可使用。REAPER 内部使用纯 Lua，外部使用普通 Python 3；核心桥接和 MCP 服务无需 pip 软件包。 音频转鼓组 MIDI 转录使用独立的可选模型环境。每次更改都会在 REAPER 撤销块内执行，因此按 Ctrl+Z 即可撤销 Agent 所做的任何操作。

安装

Reaper Daemon 分为两部分：在 REAPER 内部运行的 Lua 桥接，以及与其通信的工具。两者都来自 REAPER 所在计算机上克隆的本仓库，因此请先在这里安装，即使你是通过 Claude 插件目录找到它的。

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

重启 REAPER，然后检查桥接是否正常运行：

python3 reaperd.py status

渲染和音频捕获默认关闭，需先允许才能使用；所有测量都需要这些功能，包括 verify_change。要启用这些功能，请运行：

python3 setup/install.py --allow-audio-writes

保存项目、更改 REAPER 偏好设置和运行 Lua 脚本各有独立开关；请参阅 docs/install.md。

更喜欢使用 ReaPack，或想手动加载桥接？请参阅 docs/install.md。

Claude 插件

本仓库也是一个 Claude 插件，内含 MCP 服务和五项技能：设置、鼓组编曲、鼓组人性化处理、吉他与贝斯声部，以及为现有编曲创作 MIDI。该插件会执行上述安装流程，因此如果你在安装之前添加了插件，请让 Claude 设置 Reaper Daemon。设置技能会查找缺失的内容，与你一起克隆并运行安装程序，询问要允许哪些磁盘写入操作，并检查 REAPER 是否响应。

添加插件时，Claude 会询问两个设置：

• Reaper Daemon 文件夹：克隆仓库的位置。默认值为 ~/reaper-daemon。
• Python 命令：默认值为 python3。在 Windows 上，如果 python3 不在 PATH 中，请使用 python 或 py。

Cowork 不会询问，因此会使用这些默认值。要直接从克隆的仓库在 Claude Code 中试用插件：

claude --plugin-dir /path/to/reaper-daemon

MCP 服务运行在你的计算机上，与 REAPER 同处一台设备。它可在 Claude Code 和你计算机上的 Cowork 会话中使用。claude.ai 上的聊天会加载技能，但无法连接 REAPER。

使用 AI Agent 混音

让 Claude 或任何与 Reaper Daemon 通信的 Agent 连接到已打开的 REAPER 会话，并要求它处理混音。它会使用 scan_fx 读取每个插件及其参数，以 "-2.5 dB" 这样的实际单位设置 FX 值，并编写自动化。verify_change 会在调整前后捕获音轨，并报告音频发生了哪些变化，因此你无需盲目相信它。每次调整都位于 REAPER 撤销块内，最终由你的耳朵判断。

示例提示词：

• “贝斯在 300 Hz 左右听起来很浑，把这部分降下来。”
• “把人声调低一些，让它融入混音，而不是突出在上面。”
• “调整贝斯，直到它的 LUFS 低 3 dB。”
• “鼓组总线上有哪些插件？它们的设置是什么？”

请参阅 MCP server 了解设置方法，并参阅 Verify 了解这些测量能和不能证明什么。

功能

领域	命令
项目	传输、速度和速度映射、光标、时间选区、渲染、保存
轨道	添加、删除、重命名、选择、音量、声像、静音、独奏、准备录音、颜色
路由	读取发送和接收、创建发送、切换主输出馈送
FX	添加、移除、旁通、重新排序、设置参数、写入自动化、保存链
标记、区域、媒体项目	完整读取和写入
MIDI	插入 MIDI 文件，以及支持人性化处理的鼓组 DSL
转录	将音频项目转换为鼓组 MIDI，可选使用本地分析运行时
吉他和贝斯	shred 渲染经过人性化处理的 Riff，band 剪辑出完整的节奏组
发现	scan_fx 导出所有插件和参数；discover_drum_map 读取任意鼓组的音符映射
验证	在混音调整前后测量响度、频谱和动态
操作和脚本	搜索并运行 REAPER 操作列表中的任意操作；按源代码或路径运行 Lua，需通过独立开关启用

此桥接不依赖任何特定插件或鼓组库。Agent 会发现项目中的内容，并按名称对其进行操作。

三种交互方式

CLI。 一个 Python 入口即可处理 Agent 执行的所有操作。

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

MCP 服务。 reaper_mcp.py 将桥接封装为通过 stdio 调用的工具。 让 Claude Desktop “测量鼓组”，它就会执行。

Daemon Console。 停靠在 REAPER 内部的聊天面板，由无头 Claude Code 会话提供支持，始终知道你选中了哪个轨道。

文档

安装	一行安装程序、ReaPack、手动加载
CLI	reaperd.py 参考
MCP 服务	Claude Desktop 和其他客户端的设置
Daemon Console	REAPER 内的聊天面板
鼓组	鼓组发现、分轨分析、人性化处理
作曲工作流	使用采样乐器创作完整歌曲：测量、奏法、变化镲片、验证
鼓组工作坊	独立的创作概要、MIDI 比较、限定范围的试听反馈
鼓组转录	音频转 MIDI、后台任务、鼓组映射
吉他和贝斯	shred 和 band
混音方案	捕获、比较和重建混音设置
验证	通过测量结果验证闭环混音调整
协议	文件线缆格式
故障排除	静音采集、过期心跳
看门狗	无人值守运行：重新启动 REAPER、处理对话框、清理过期队列文件
歌曲规划器	乐器库、歌曲表、已批准的草稿
安全	信任模型和可选令牌
开发	测试、CI、仓库布局

Agent 应阅读 AGENTS.md、CLAUDE.md 和 bridge/command_schema.md。两个随附技能 arrangement-midi 和 drum-humanize 涵盖 MIDI 作曲和 鼓组人性化处理。song-planner 可根据概要、Riff 或参考曲目规划并起草完整歌曲。

安全

任何能够写入 inbox/ 的进程都可以驱动 REAPER。请将桥接文件夹保留在本地，不要放在共享驱动器上。详情请见 docs/security.md。

运行和发送的内容

所有内容都在你的计算机上运行。MCP 服务和命令行都是纯 Python，不会发起网络请求。桥接程序是在 REAPER 中运行的 Lua 脚本。它通过 Reaper Daemon 文件夹与服务交换 JSON 文件，该文件夹还存放日志和生成的 MIDI 文件。只有启用音频写入后，渲染和捕获才会写入音频文件；默认情况下此功能处于关闭状态。没有任何内容会离开你的计算机。

三个可选组件只有在安装后才会执行额外操作：

• 鼓轨转录会在设置期间下载其 Python 软件包和模型权重，Demucs 则会在首次分离任务时下载权重。 音频始终保留在本地。
• analyze_track 和 compare_tracks 会从你的 PATH 运行 Post Mortem。
• Daemon Console 会在你的计算机上启动 Claude Code 会话，该会话会像任何 Claude Code 会话一样与 Anthropic 通信。

许可证

MIT。请参阅 LICENSE。

键盘演奏设置、MIDI/控制器测试和模板保存说明见演奏工作流。