REAPER MCP 服务器
一个全面的模型上下文协议（MCP）服务器，使 AI 代理能够在 REAPER 中创建完全混音和母带处理的音轨，支持 MIDI 和音频功能。
功能
- 完整的项目管理（创建、保存、渲染）
- 音轨操作（创建、路由、参数调整）
- MIDI 作曲与编辑
- 音频录制与导入
- 虚拟乐器和效果器管理
- 混音与自动化
- 母带处理工具
- 音频分析与反馈
要求
- 已安装 REAPER DAW
- Python 3.8+
- 在 REAPER 中启用 OSC 支持（适用于 OSC 模式）
- 在 REAPER 中启用 ReaScript API（适用于 ReaScript 模式）
安装
使用
快速开始
最简单的启动方式是使用提供的启动脚本：
配置
默认情况下，服务器将使用 OSC 模式，该模式更可靠且不需要 ReaScript API 正常工作。你可以通过命令行参数配置服务器：
在 REAPER 中设置 OSC
- 打开 REAPER
- 进入 Preferences > Control/OSC/web
- 点击 "Add" 并选择 "OSC (Open Sound Control)"
- 配置以下设置：
- 设备名称：ReaperMCP
- 模式：Local port
- 本地监听端口：8000
- 本地 IP：127.0.0.1（或你的计算机 IP 地址）
- 允许绑定消息到 REAPER 操作和 FX 学习：勾选（可选）
- 输出最大数据包大小：1024
- 数据包之间的等待时间：10ms
在 REAPER 中设置 ReaScript
- 打开 REAPER
- 进入 Preferences > Plug-ins > ReaScript
- 确保 "Enable Python for ReaScript" 已勾选
- 将 Python DLL/dylib 路径设置为你的 Python 安装路径
- 在 macOS 上：
/opt/homebrew/Cellar/python@3.x/3.x.x/Frameworks/Python.framework/Versions/3.x/Python - 在 Windows 上：
C:\Path\to\Python\python3x.dll
- 运行设置脚本：
项目结构
src/reaper_mcp/: 主包目录__main__.py: 命令行接口osc_server.py: 基于 OSC 的服务器实现server.py: 基于 ReaScript 的服务器实现
examples/: 示例脚本，展示使用方法
scripts/: 用于设置和运行的实用脚本
MCP 工具
服务器提供以下 MCP 工具：
create_project: 创建一个新的 REAPER 项目
create_track: 在当前项目中创建一个新音轨
list_tracks: 列出当前项目中的所有音轨
add_midi_note: 向音轨添加一个 MIDI 音符
get_project_info: 获取当前项目的信息
故障排除
ReaScript API 问题
如果你遇到 ReaScript API 的问题，可以尝试使用 OSC 模式：
OSC 通信问题
确保 REAPER 已正确配置 OSC：
- 检查 REAPER 中的 OSC 设置是否与服务器设置匹配
- 确认没有防火墙阻止通信
- 尝试使用本地 IP 地址（127.0.0.1）而不是网络 IP
许可证
MIT
- Author:waytomcp
- URL:https://www.waytomcp.com/article/itsuzef/reaper-mcp
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
