金大哥 - REAPER MCP 详情

article

README

🚀 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 符号。
项目信息获取：获取有关当前项目的详细信息。

📦 安装指南

安装要求

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

安装步骤

使用 Git 克隆仓库：
```
git clone [仓库地址]
```

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

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

安装依赖项：
```
pip install -r requirements.txt
```
启动服务器：
```
python -m src.reaper_mcp.server
```

📚 详细文档

配置选项

默认模式：OSC 模式。

ReaScript 模式：

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

REAPER 设置

OSC 模式配置

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

ReaScript 模式配置

运行脚本：

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 特定问题解决

脚本执行问题：
- 对于 PowerShell 脚本，可能需要调整执行策略：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
端口冲突：
- 确保目标端口（默认 5000）未被其他程序占用。

📄 许可证

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

📞 联系方式

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

感谢使用 REAPER MCP 服务器！

REAPER