REAPER

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 服务器!

  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-27 20:03

相似服务问题