STARWARCLOUD STARWAR.AI
返回市场
收割者-mcp

收割者-mcp

作者：itsuzef20 星标更新：2025-05-02
安装使用来源：spider==github.com

项目介绍

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