Reaper MCP Server

收割者MCP服务器

这是一个MCP服务器，它将Reaper项目连接到像Claude Desktop这样的MCP客户端，使您能够询问有关项目的问题，并获得全面的音频分析以获得混音反馈。

工具

项目发现和解析

• find_reaper_projects：查找您在配置中指定的目录中的所有Reaper项目。
• parse_reaper_project：解析收割者项目文件（.RPP）并返回详细信息，包括节奏、曲目、FX链和音频项。

这些工具协同工作。当你问克劳德一个关于特定收割者项目的问题时，它会使用 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插件？” - “显示我的所有音频单元插件”

注： 此工具扫描您的Reaper插件缓存文件。如果您最近安装了新插件，但尚未在Reaper中扫描它们，则它们不会出现在结果中。确保打开Reaper，让它先扫描新插件。

音频分析

• analyze_audio_files(project_path, track_filter=None)：分析Reaper项目中的所有音频文件，以获得混合反馈。

参数：

- project_path （必填）：路径。RPP项目文件 - track_filter （可选）：按名称过滤曲目（例如，“Vocal”仅分析人声曲目）

退货： 全面的音频分析包括：

- 水平分析：峰值电平、RMS、限幅检测 - 频率分析：频谱内容、频带间的能量分布 - 立体成像：立体声宽度、相位相干性、单声道兼容性 - 动态范围和音量：LUFS（响度标准）、真峰值、波峰系数

示例问题：

- “分析我摇滚歌曲项目中的所有音频” - “检查音轨是否剪切” - “我的混音对于流媒体平台来说太吵了吗？” - “我的鼓声有相位问题吗？”

警告阈值：

- 峰值>-0.3 dBFS：削波风险 - 检测到剪切：存在数字失真 - 低频能量过大（>-6dB）：混匀 - 相位相干性\-8：流媒体播放声音太大（Spotify目标：-14 LUFS） - 峰值因子\<6 dB：可能过度压缩

要查看从项目解析的所有数据结构，请查看 src/reaper_mcp_server/reaper_dataclasses.py 文件。

设置

1. 安装依赖项

   uv venv
   source .venv/bin/activate

   uv pip install .

1. 配置Claude桌面

- 跟随 配置Claude Desktop的说明 用于自定义MCP服务器 - 在中查找示例配置 setup/claude_desktop_config.json - 更新配置中的以下路径： - 你的 uv 安装路径 - 您的Reaper项目目录 - 此服务器的目录

1. 启动和配置

- 打开克劳德桌面 - 点击聊天框上的“+”图标 - 点击“连接器”，您应该看到“收割器”连接器已启用

Claude Desktop Connectors

1. 走开！

- 询问有关收割者项目的问题 - 始终包含您询问的特定收割者项目的名称 - 您可以展开工具箱，查看传递给Claude的原始项目数据 Claude Desktop Tools