REAPER MCP 服务器

全面的模型上下文协议 (MCP) 服务器，使 AI 代理能够在 REAPER 中创建具有 MIDI 和音频功能的完全混合和掌握的曲目。

特征

完整的项目管理（创建、保存、渲染）
轨道操作（创建、路由、参数调整）
MIDI 创作和编辑
音频录制和导入
虚拟仪器和效果管理
混合和自动化
掌握工具
音频分析和反馈

要求

REAPER DAW 安装
Python 3.8+
REAPER 中启用 OSC 支持（用于 OSC 模式）
REAPER 中启用 ReaScript API（用于 ReaScript 模式）

安装

# Clone the repository git clone https://github.com/itsuzef/reaper-mcp.git cd reaper-mcp # Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install the package pip install -e .

用法

快速入门

最简单的开始方式是使用提供的启动脚本：

# Start REAPER first open /Applications/REAPER.app # On macOS # or start REAPER manually on other platforms # Then start the MCP server ./scripts/start_reaper_mcp_server.sh # On Unix/Mac

Windows 用户

对于 Windows 用户，请使用提供的 Windows 脚本之一：

# Using Command Prompt (CMD) scripts\start_reaper_mcp_server.bat # Using PowerShell powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1

配置

默认情况下，服务器将使用 OSC 模式，该模式更可靠，并且不需要 ReaScript API 正常工作。您可以使用命令行参数配置服务器：

# Start in OSC mode (default) ./scripts/start_reaper_mcp_server.sh --mode=osc # Unix/Mac scripts\start_reaper_mcp_server.bat --mode=osc # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -mode osc # Windows PowerShell # Start in ReaScript mode ./scripts/start_reaper_mcp_server.sh --mode=reapy # Unix/Mac scripts\start_reaper_mcp_server.bat --mode=reapy # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -mode reapy # Windows PowerShell # Configure OSC settings (Unix/Mac) ./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000 # Configure OSC settings (Windows CMD) scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000 # Configure OSC settings (Windows PowerShell) powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000 # Enable debug logging ./scripts/start_reaper_mcp_server.sh --debug # Unix/Mac scripts\start_reaper_mcp_server.bat --debug # Windows CMD powershell -File scripts\start_reaper_mcp_server.ps1 -debug # Windows PowerShell

为 OSC 设置 REAPER

打开 REAPER
前往“首选项”>“控制/OSC/web”
点击“添加”，选择“OSC（打开声音控制）”
配置以下设置：
- 设备名称：ReaperMCP
- 模式：本地端口
- 本地监听端口：8000
- 本地IP：127.0.0.1（或您计算机的IP地址）
- 允许将消息绑定到 REAPER 操作和 FX 学习：选中（可选）
- 传出最大数据包大小：1024
- 数据包之间等待时间：10ms

为 ReaScript 设置 REAPER

打开 REAPER
转到“首选项”>“插件”>“ReaScript”
确保选中“为 ReaScript 启用 Python”
将 Python DLL/dylib 路径设置为 Python 安装
- 在 macOS 上： /opt/homebrew/Cellar/python@3.x/3.xx/Frameworks/Python.framework/Versions/3.x/Python
- 在 Windows 上： C:\Path\to\Python\python3x.dll
运行安装脚本：
python scripts/setup_reaper_python.py

项目结构

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 模式：

./scripts/start_reaper_mcp_server.sh --mode=osc

OSC 通信问题

确保 REAPER 已针对 OSC 正确配置：

检查 REAPER 中的 OSC 设置是否与服务器设置匹配
确认没有防火墙阻止通信
尝试使用本地 IP 地址 (127.0.0.1) 而不是网络 IP

Windows 特定的故障排除

如果您在 Windows 上运行 MCP 服务器时遇到问题：

脚本执行问题：
- 对于 PowerShell 脚本，您可能需要调整执行策略： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- 或者，使用-ExecutionPolicy Bypass标志，如示例所示
路径问题：
- 确保脚本中的 REAPER 路径与您的安装位置匹配
- 默认为C:\Program Files\REAPER\reaper.exe ，可根据需要修改
虚拟环境：
- 如果您使用不同的方法创建了 venv，则激活脚本可能位于不同的位置
- 运行之前尝试手动激活： venv\Scripts\activate
防火墙阻止：
- Windows 防火墙可能会阻止 OSC 通信
- 在 Windows 防火墙设置中添加 Python 和 REAPER 的例外
管理员权限：
- 如果遇到权限问题，请尝试以管理员身份运行命令提示符或 PowerShell