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 服務器！