REAPER

🚀 REAPER MCP サーバー

REAPER MCP サーバーは、包括的なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、人工知能エージェントが REAPER 内で完全なミキシングとマスタリングトラックを作成できます。MIDI とオーディオ機能をサポートしており、ユーザーが音楽プロジェクトを効率的に管理および制御できるようになっています。

✨ 主な機能

• 完全なプロジェクト管理：プロジェクトの作成、保存、レンダリングを含みます。
• トラック作成：現在のプロジェクトに新しいトラックを追加できます。
• トラックリスト：現在のプロジェクト内のすべてのトラックをリスト表示します。
• 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 [リポジトリの URL]
   

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
   

💻 使用例

クイックスタート

1. サーバーの起動（ターミナルまたはコマンドプロンプトで）

   # macOS/Linux の場合
   cd [プロジェクトディレクトリ]
   source venv/bin/activate
   python -m src.reaper_mcp.server
   

   または、提供されている起動スクリプトを使用します。

   ./scripts/start_reaper_mcp_server.sh
   

2. ドキュメントのアクセス：サーバーが起動した後、ブラウザで http://localhost:5000 にアクセスして API ドキュメントを表示します。

設定オプション

• デフォルトモード：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
   

プロジェクト構造

• src/reaper_mcp/：メインパッケージディレクトリ
  • __main__.py：コマンドラインインターフェース。
  • osc_server.py：OSC ベースのサーバー実装。
  • server.py：ReaScript ベースのサーバー実装。
• examples/：使用例のスクリプト。
• scripts/：実用的な起動および実行スクリプト。

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 サーバーをご利用いただき、ありがとうございます！