Reaper MCP 服务器

这是一个将Reaper工程与MCP客户端（如Claude Desktop）连接的服务器，可让您针对工程提问并获取全面的音频分析以获取混音反馈。

工具集

工程发现与解析

• find_reaper_projects：在配置指定目录中查找所有Reaper工程
• parse_reaper_project：解析Reaper工程文件(.RPP)，返回包含BPM、音轨、效果器链和音频素材等详细信息

这些工具协同工作。当您向Claude询问特定Reaper工程时，系统会先使用find_reaper_projects定位工程，再通过parse_reaper_project解析工程内容来回答问题。

音频分析

• analyze_audio_files(project_path, track_filter=None)：分析Reaper工程中所有音频文件以提供混音反馈

  参数说明：

  • project_path（必填）：.RPP工程文件路径
  • track_filter（可选）：按名称筛选音轨（如"Vocal"仅分析人声音轨）

  返回内容： 包含以下维度的全面音频分析：

  • 电平分析：峰值电平、RMS值、削波检测
  • 频谱分析：频谱内容、各频段能量分布
  • 立体声场：声场宽度、相位一致性、单声道兼容性
  • 动态范围与响度：LUFS（响度标准）、真实峰值、波峰因数

  示例问题：

  • "分析我的摇滚歌曲工程中的所有音频"
  • "检查人声音轨是否有削波"
  • "我的混音对流媒体平台来说是否过响？"
  • "鼓组音轨是否存在相位问题？"

  预警阈值：

  • 峰值 > -0.3 dBFS：存在削波风险
  • 检测到削波：出现数字失真
  • 低频能量过高(> -6 dB)：混音浑浊
  • 相位一致性 < 0.5：存在相位抵消问题
  • LUFS > -8：流媒体播放过响（Spotify标准为-14 LUFS）
  • 波峰因数 < 6 dB：可能过度压缩

完整数据结构请查看src/reaper_mcp_server/reaper_dataclasses.py文件。

安装配置

1. 安装依赖

   uv venv
   source .venv/bin/activate
   
   uv pip install .
   

2. 配置Claude Desktop

   • 按照Claude Desktop配置指南设置自定义MCP服务器
   • 参考setup/claude_desktop_config.json中的示例配置
   • 更新配置中的以下路径：
     • 您的uv安装路径
     • Reaper工程目录
     • 本服务器目录

3. 启动验证

   • 打开Claude Desktop
   • 在聊天框右下角找到锤子图标
   • 点击锤子图标确认能看到三个Reaper工具：
     • find_reaper_projects
     • parse_reaper_project
     • analyze_audio_files

   

4. 开始提问

   • 咨询关于Reaper工程的问题
   • 提问时请包含具体的Reaper工程名称
   • 可展开工具框查看传递给Claude的原始工程数据