REAPER MCP Server

一个全面的模型上下文协议（MCP）服务器，使AI代理能够在REAPER中创建完全混合和母带处理的音轨，支持MIDI和音频功能。

功能

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

系统要求

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

安装

# 克隆仓库
git clone https://github.com/itsuzef/reaper-mcp.git
cd reaper-mcp

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 安装包
pip install -e .

使用方法

快速开始

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

# 首先启动REAPER
open /Applications/REAPER.app  # 在macOS上
# 或在其他平台上手动启动REAPER

# 然后启动MCP服务器
./scripts/start_reaper_mcp_server.sh  # 在Unix/Mac上

Windows用户

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

# 使用命令提示符（CMD）
scripts\start_reaper_mcp_server.bat

# 使用PowerShell
powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1

配置

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

# 启动OSC模式（默认）
./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

# 启动ReaScript模式
./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

# 配置OSC设置（Unix/Mac）
./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000

# 配置OSC设置（Windows CMD）
scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000

# 配置OSC设置（Windows PowerShell）
powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000

# 启用调试日志
./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

设置REAPER以使用OSC

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

设置REAPER以使用ReaScript

1. 打开REAPER
2. 前往首选项 > 插件 > ReaScript
3. 确保“启用ReaScript中的Python”已选中
4. 将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
5. 运行设置脚本：

   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：

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

Windows特定故障排除

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

1. 脚本执行问题：

   • 对于PowerShell脚本，您可能需要调整执行策略：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   • 或者，如示例所示，使用-ExecutionPolicy Bypass标志

2. 路径问题：

   • 确保脚本中的REAPER路径与您的安装位置匹配
   • 默认路径是C:\Program Files\REAPER\reaper.exe，如有必要请修改

3. 虚拟环境：

   • 如果您使用不同的方法创建了venv，激活脚本可能位于不同位置
   • 尝试手动激活后再运行：venv\Scripts\activate

4. 防火墙阻塞：

   • Windows防火墙可能会阻止OSC通信
   • 在Windows防火墙设置中为Python和REAPER添加例外

5. 管理员权限：

   • 如果遇到权限问题，请尝试以管理员身份运行命令提示符或PowerShell

许可证

MIT