REAPER

🚀 REAPER MCP 服务器

REAPER MCP 服务器是一款综合性的模型上下文协议（MCP）服务器，它能让人工智能代理在 REAPER 里创建完整的混音和母带处理轨道。该服务器支持 MIDI 和音频功能，可帮助用户高效管理和控制音乐项目。

🚀 快速开始

启动服务器

你可以在终端或命令提示符中按以下步骤操作：

# 在 macOS/Linux 中
cd [项目目录]
source venv/bin/activate
python -m src.reaper_mcp.server

或者使用提供的启动脚本：

./scripts/start_reaper_mcp_server.sh

访问文档

服务器启动后，你可以通过浏览器访问 http://localhost:5000 查看 API 文档。

✨ 主要特性

• 完整项目管理：涵盖项目的创建、保存和渲染。
• 轨道创建：可在当前项目中添加新的轨道。
• 轨道列表：列出当前项目中的所有轨道。
• MIDI 符号添加：向选定的轨道添加 MIDI 符号。
• 项目信息获取：获取有关当前项目的详细信息。

📦 安装指南

安装要求

1. REAPER DAW：确保已安装 REAPER 数字音频工作站。
2. Python 3.8 或更高版本：需要安装 Python 环境以运行服务器。
3. OSC 支持：确保 REAPER 已启用 OSC（Open Sound Control）通信。
4. ReaScript API 支持：确认 REAPER 已启用 ReaScript 脚本接口。

安装步骤

1. 使用 Git 克隆仓库：

   git clone [仓库地址]
   

2. 创建并激活虚拟环境（推荐使用 Python 3.8+）：

   python -m venv venv
   source venv/bin/activate  # 在 macOS/Linux 中
   venv\Scripts\activate     # 在 Windows 中
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 启动服务器：

   python -m src.reaper_mcp.server
   

📚 详细文档

配置选项

• 默认模式：OSC 模式。
• ReaScript 模式：

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

REAPER 设置

OSC 模式配置

1. 打开 REAPER 的“Options”菜单，选择“Preferences”。
2. 在左侧菜单中找到“Network”部分。
3. 启用 OSC 支持，并将端口设置为 5000。
4. 确保“Enabled”选项已勾选。

ReaScript 模式配置

1. 运行脚本：

   python src/reaper_mcp/scripts/setup_reaper_python.py
   

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 设置与服务器配置匹配。
• 检查防火墙是否阻止了相关端口。
• 尝试使用本地 IP 地址（127.0.0.1）进行通信。

Windows 特定问题解决

1. 脚本执行问题：
   • 对于 PowerShell 脚本，可能需要调整执行策略：

     Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
     

2. 端口冲突：
   • 确保目标端口（默认 5000）未被其他程序占用。

📄 许可证

本项目遵循 MIT 许可证。详情请查阅 LICENSE 文件。

📞 联系方式

如需反馈或问题，请联系 [维护人员邮箱] 或访问 [项目主页]。

感谢使用 REAPER MCP 服务器！