REAPER MCP 服务器

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

特征

• 完整的项目管理（创建、保存、渲染）

• 轨道操作（创建、路由、参数调整）

• MIDI 创作和编辑

• 音频录制和导入

• 虚拟仪器和效果管理

• 混合和自动化

• 掌握工具

• 音频分析和反馈

Related MCP server: Ableton Copilot MCP

要求

• 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

1. 打开 REAPER

2. 前往“首选项”>“控制/OSC/web”

3. 点击“添加”，选择“OSC（打开声音控制）”

4. 配置以下设置：

   • 设备名称：ReaperMCP

   • 模式：本地端口

   • 本地监听端口：8000

   • 本地IP：127.0.0.1（或您计算机的IP地址）

   • 允许将消息绑定到 REAPER 操作和 FX 学习：选中（可选）

   • 传出最大数据包大小：1024

   • 数据包之间等待时间：10ms

为 ReaScript 设置 REAPER

1. 打开 REAPER

2. 转到“首选项”>“插件”>“ReaScript”

3. 确保选中“为 ReaScript 启用 Python”

4. 将 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

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

执照

麻省理工学院