REAPER MCP サーバー
AI エージェントが MIDI とオーディオの両方の機能を使用して REAPER で完全にミックスされマスタリングされたトラックを作成できるようにする包括的な Model Context Protocol (MCP) サーバー。
特徴
- 完全なプロジェクト管理（作成、保存、レンダリング）
- トラック操作（作成、ルーティング、パラメータ調整）
- MIDI作曲と編集
- オーディオ録音とインポート
- 仮想楽器とエフェクトの管理
- ミキシングとオートメーション
- マスタリングツール
- 音声分析とフィードバック
要件
- REAPER DAWをインストール
- Python 3.8以上
- REAPER で OSC サポートが有効になっています (OSC モードの場合)
- REAPER で ReaScript API が有効になりました (ReaScript モード用)
インストール
# Clone the repository
git clone https://github.com/itsuzef/reaper-mcp.git
cd reaper-mcp
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install the package
pip install -e .
使用法
クイックスタート
最も簡単な方法は、提供されている起動スクリプトを使用することです。
# Start REAPER first
open /Applications/REAPER.app # On macOS
# or start REAPER manually on other platforms
# Then start the MCP server
./scripts/start_reaper_mcp_server.sh # On Unix/Mac
Windowsユーザー
Windows ユーザーの場合は、提供されている Windows スクリプトのいずれかを使用します。
# Using Command Prompt (CMD)
scripts\start_reaper_mcp_server.bat
# Using PowerShell
powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1
構成
デフォルトでは、サーバーはOSCモードを使用します。これはより信頼性が高く、ReaScript APIが正しく動作している必要がありません。コマンドライン引数を使用してサーバーを設定できます。
# Start in OSC mode (default)
./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
# Start in ReaScript mode
./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
# Configure OSC settings (Unix/Mac)
./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000
# Configure OSC settings (Windows CMD)
scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000
# Configure OSC settings (Windows PowerShell)
powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000
# Enable debug logging
./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
OSC 用の REAPER の設定
- REAPERを開く
- 環境設定 > コントロール/OSC/Web に移動します。
- 「追加」をクリックし、「OSC（Open Sound Control）」を選択します。
- 次の設定を構成します。
- デバイス名: ReaperMCP
- モード: ローカルポート
- ローカルリスンポート: 8000
- ローカル IP: 127.0.0.1 (またはコンピュータの IP アドレス)
- REAPERアクションとFX学習へのバインディングメッセージを許可する: チェックあり（オプション）
- 送信最大パケットサイズ: 1024
- パケット間の待機時間: 10ms
ReaScript用のREAPERの設定
- REAPERを開く
- 設定 > プラグイン > ReaScript に移動します
- 「ReaScriptでPythonを有効にする」がチェックされていることを確認してください
- Python DLL/dylib パスを Python インストールに設定します
- macOS の場合:
/opt/homebrew/Cellar/python@3.x/3.xx/Frameworks/Python.framework/Versions/3.x/Python - Windowsの場合:
C:\Path\to\Python\python3x.dll
- セットアップ スクリプトを実行します。
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 に対して正しく設定されていることを確認します。
- REAPERのOSC設定がサーバーの設定と一致していることを確認します。
- ファイアウォールが通信をブロックしていないことを確認する
- ネットワークIPの代わりにローカルIPアドレス（127.0.0.1）を使用してみてください
Windows固有のトラブルシューティング
Windows で MCP サーバーを実行する際に問題が発生する場合:
- スクリプト実行の問題:
- PowerShell スクリプトの場合、実行ポリシーを調整する必要がある場合があります:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser - あるいは、例に示すように
-ExecutionPolicy Bypassフラグを使用します。
- パスの問題:
- スクリプト内のREAPERパスがインストール場所と一致していることを確認してください。
- デフォルトは
C:\Program Files\REAPER\reaper.exeです。必要に応じて変更してください。
- 仮想環境:
- 別の方法でvenvを作成した場合、アクティベーションスクリプトは別の場所にある可能性があります。
- 実行する前に手動でアクティベートしてみてください:
venv\Scripts\activate
- ファイアウォールブロック:
- WindowsファイアウォールがOSC通信をブロックする可能性がある
- Windows ファイアウォール設定で Python と REAPER の例外を追加する
- 管理者権限:
- 権限の問題が発生した場合は、コマンドプロンプトまたはPowerShellを管理者として実行してみてください。
ライセンス
マサチューセッツ工科大学