Reaper MCP Server

Reaper MCP 服务

这是一个 MCP 服务，可将 Reaper 项目连接到 Claude Desktop 等 MCP 客户端，让你能够询问项目相关问题，并获取全面的音频分析和混音反馈。

此服务在设计上是只读的。它不提供任何可让 AI 修改项目的工具。它擅长帮助你了解已有作品，并学习如何改进。你可以让 AI 提出一些想法，然后自己尝试调整旋钮，通过实践了解这些调整对音乐的影响。

工具

项目发现与解析

• find_reaper_projects：查找你在配置中指定的目录里的所有 Reaper 项目。

• parse_reaper_project：解析 Reaper 项目文件（.RPP），并返回详细信息，包括速度、轨道、FX 链和音频片段。

  每条轨道都包含其位置和标识信息（track_number 与 Reaper 中显示的顺序一致，guid）、路由信息（is_folder/folder_depth、main_send、receives、num_channels、midi_hardware_out）以及混音器状态（volume、pan、mute、solo）。每个片段都包含 position、length、start_offset、playrate、mute、淡入淡出信息以及所有录音片段（take）——其中会标记当前活动的录音片段，因为实际播放的就是它。

  receives 条目会按索引和名称注明源轨道，据此可以区分实时信号路径和遗留轨道：main_send: false 的轨道不会输出到主控，其音频只能通过接收它信号的轨道听到。

这些工具配合使用。当你向 Claude 询问某个 Reaper 项目的具体问题时，它会先使用 find_reaper_projects 工具查找项目，再使用 parse_reaper_project 工具解析项目并回答问题。

已安装 FX 发现

• list_installed_fx(plugin_type=None, search_query=None)：列出 Reaper 中所有可用的已安装 FX/插件。

  参数：

  • plugin_type（可选）：按插件类型筛选（VST2、VST3、AU、JS、CLAP）
  • search_query（可选）：按插件名称、制造商或类型搜索插件

  **返回：**已安装插件列表，包括：

  • 插件名称
  • 插件类型（VST2、VST3、AU、JS、CLAP）
  • 文件路径
  • 制造商（如有）

  示例问题：

  • “我安装了哪些合成器插件？”
  • “列出我所有的 Waves 插件”
  • “我想找一款音色飘忽的合成器。我已安装的插件里有哪些选择？”
  • “列出我所有的 VST3 插件”
  • “我有混响插件吗？”
  • “我有哪些 iZotope 插件？”
  • “列出我所有的 Audio Unit 插件”

  **注意：**此工具会扫描 Reaper 插件缓存文件。如果你最近安装了新插件，但还没有在 Reaper 中扫描过，它们就不会出现在结果中。请先打开 Reaper 并让它扫描新插件。

音频分析

• analyze_audio_files(project_path, track_filter=None, whole_file=False)：分析 Reaper 项目中的音频，提供混音反馈。

  参数：

  • project_path（必需）：.RPP 项目文件的路径。必须位于 --reaper-projects-dir 内。
  • track_filter（可选）：按名称筛选音轨（例如，使用 "Vocal" 仅分析人声轨道）
  • whole_file（可选）：分析整个源文件，而非仅分析每个素材项播放的片段。默认关闭。

  **返回：**全面的音频分析，包括：

  • 电平分析：峰值电平、RMS、削波检测、直流偏移
  • 频率分析：频谱质心，以及各频段占总能量的比例
  • 立体声成像：立体声宽度、相位相干性、单声道兼容性
  • 动态范围与响度：LUFS（响度标准）、真峰值、峰均比

  示例问题： -“分析我的 Rock Song 项目中的所有音频” -“检查人声轨道是否有削波” -“我的混音对于流媒体平台来说是否太响？” -“我的鼓轨道是否存在相位问题？”

  **测量内容：**默认情况下，每个素材项都严格按照其播放的片段进行分析，包括源文件起始偏移、长度和播放速率，而非分析整个源文件。相同的片段只分析一次，并重复使用，因此在编曲中重复出现的素材项只需测量一次。MIDI 素材项没有音频源，因此会列在 skipped 下，而不会报告为错误。

  **频率数据为相对值。**每个频段都以其占该片段总频谱功率的比例表示（并同时提供相应的 dB 值）。绝对频段能量会随片段长度变化，因此相同内容的长文件可能比短文件高出数十 dB，导致跨文件比较毫无意义。

  **这些数值是在 FX 处理前测得的。**分析会读取磁盘上的源文件，因此既不反映音轨的 FX 链，也不反映推子设置。如果音轨使用了模拟器或重度 EQ，分析描述的是原始 DI 信号，而不是你实际听到的声音。每个响应都会标注 signal_stage: pre-fx。

  警告阈值：

  • 峰值 > -0.3 dBFS：存在削波风险
  • 检测到削波：存在数字失真
  • 200–500 Hz 比 500–2000 Hz 高出 10 dB 以上：低中频发闷。比较这两个频段的相对电平，而不是将某个频段与整个频谱比较，可以避免仅仅因为贝斯部分本来如此就触发警告。
  • 平均采样值 > 0.001：直流偏移
  • 相位相干性 < 0.5：存在相位抵消问题
  • LUFS > -8：流媒体响度过高（Spotify 目标值：-14 LUFS）
  • 峰均比 < 6 dB：可能存在过度压缩

  无法测量响度时（片段短于 400 ms），响度会报告为 null，而不是用替代值表示；短于 50 ms 的片段仍会测量，但不会触发警告。

如需查看从项目中解析出的所有数据结构，请参阅 src/reaper_mcp_server/reaper_dataclasses.py 文件。

设置

你需要安装 uv。无需克隆此仓库或创建虚拟环境——uvx 会为你获取、构建并运行服务，并自行管理 Python。

1. 配置 Claude Desktop

按照配置 Claude Desktop 中针对自定义 MCP 服务的说明操作，然后使用 setup/claude_desktop_config.json 中的示例：

{
    "mcpServers": {
        "reaper": {
            "command": "/path/to/your/uv-installation/uvx",
            "args": [
                "--from",
                "git+https://github.com/dschuler36/reaper-mcp-server",
                "reaper-mcp-server",
                "--reaper-projects-dir",
                "/path/to/your/reaper/projects"
            ]
        }
    }
}

需要填写两个路径：

• uvx — 使用绝对路径，而不是单独填写 uvx。Claude Desktop 不会继承 shell 的 PATH，因此仅填写命令名称将无法启动。运行 which uvx 查找路径（通常为 ~/.local/bin/uvx）。
• --reaper-projects-dir — 存放 Reaper 项目的目录。服务只会打开该目录内的 .RPP 文件。

若要获取之后提交的新版本，请运行一次 uvx --refresh --from git+https://github.com/dschuler36/reaper-mcp-server reaper-mcp-server --help，或者清除 uv 缓存后重启 Claude Desktop。

改用 Claude Code

claude mcp add reaper -- \
  uvx --from git+https://github.com/dschuler36/reaper-mcp-server \
  reaper-mcp-server --reaper-projects-dir /path/to/your/reaper/projects

2. 启动和配置

• 打开 Claude Desktop
• 点击聊天框上的“+”图标
• 点击“连接器”，此时应该能看到已启用的“reaper”连接器

3. 尽情提问！

• 询问有关 Reaper 项目的问题
• 提问时，务必注明所询问的具体 Reaper 项目名称
• 展开工具框，即可查看传递给 Claude 的原始项目数据

从克隆副本运行

如果要修改服务，请克隆该项目，并让 Claude 使用你的工作副本。每次启动时，uv run 都会同步锁定的依赖，因此无需单独安装：

git clone https://github.com/dschuler36/reaper-mcp-server
cd reaper-mcp-server
uv sync                       # optional — only needed for running tests
uv run --group dev pytest

然后使用 setup/claude_desktop_config_local.json，该配置会从你的克隆副本运行服务：

{
    "mcpServers": {
        "reaper": {
            "command": "/path/to/your/uv-installation/uv",
            "args": [
                "--directory",
                "/path/to/this/repo/reaper-mcp-server/",
                "run",
                "reaper-mcp-server",
                "--reaper-projects-dir",
                "/path/to/your/reaper/projects"
            ]
        }
    }
}