Total Reaper MCP

🚀 REAPER MCP Server

REAPER MCP Serverは、REAPER DAW の機能をクリーンなAPIインターフェースを通じて公開するMCP（Model Context Protocol）サーバーです。これにより、REAPERの高度な機能を外部から簡単に利用できるようになります。

🚀 クイックスタート

このセクションでは、REAPER MCP Serverの利用方法の概要を説明します。まずは、必要な環境をセットアップし、簡単なインストール手順を実行しましょう。

✨ 主な機能

• クロスプラットフォーム対応：REAPERがクロスプラットフォームで一貫したサポートを提供しているため、macOS、Windows、Linuxで動作します。
• 高度なAPIインターフェース：REAPERの機能をクリーンなAPIインターフェースを通じて公開します。
• ハイブリッドアーキテクチャ：LuaとPythonを組み合わせたアーキテクチャを採用しています。

📦 インストール

クイックインストール (macOS)

./scripts/install.sh

このスクリプトを実行すると、以下の操作が行われます：

• LuaブリッジをREAPERのScriptsフォルダにインストールします。
• REAPERが起動時にブリッジを読み込むように設定します。
• Python仮想環境をセットアップします。
• 起動スクリプトを作成します。
• 必要に応じて、ログイン時に自動起動するように設定します。

注意：クイックインストールスクリプトは古い設定を参照している場合があります。最も信頼できるセットアップ方法は、以下の手動設定の手順に従ってください。

手動設定

1. Python依存関係のインストール

# 仮想環境を作成してアクティブ化する (Python 3.10+ が必要)
python3.10 -m venv .venv
source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate

# パッケージをインストールする
pip install -e .

2. ブリッジのセットアップ

現在、ファイルベースのブリッジのみが完全に実装され、テストされています。ソケットベースのブリッジは存在しますが、対応するサーバー実装がありません。

ファイルベースのブリッジ (推奨)

この方法は追加の依存関係が必要なく、最も信頼性が高いです：

1. ブリッジスクリプトをREAPERにコピーします：

   cp lua/mcp_bridge_file_v2.lua ~/Library/Application\ Support/REAPER/Scripts/
   

2. REAPERでブリッジを読み込みます：
   • REAPERを開きます。
   • Actions → Show action listに移動します。
   • "Load..."をクリックし、mcp_bridge_file_v2.luaを選択します。
   • アクションを実行します（REAPERコンソールに起動メッセージが表示されることを確認します）。
3. MCPサーバーを起動します：

   python -m server.app
   

注意：サーバーのログにはmcp_bridge_file_v2.luaが表示されます。REAPERでこのバージョンが読み込まれていることを確認してください。

ソケットベースのブリッジ (現在未実装)

ソケットベースの通信にはLuaスクリプトlua/mcp_bridge.luaが存在しますが、対応するPythonサーバー実装がありません。ソケットブリッジはLuaSocketが必要で、UDPポート9000で待機するサーバーが必要です。

3. セットアップの検証

1. REAPERコンソールに "MCP Bridge Started" が表示されることを確認します。
2. Pythonサーバーに "Server ready. Waiting for connections..." が表示されることを確認します。
3. ブリッジは~/Library/Application Support/REAPER/Scripts/mcp_bridge_data/を介してファイルベースの通信を行います。

💻 使用例

基本的な使用法

まずは、サーバーを起動して、MCPクライアントからリクエストを送信する基本的な使用方法を紹介します。

高度な使用法

特定のREAPER APIを呼び出して、高度な機能を利用する方法を紹介します。

📚 ドキュメント

プラットフォームサポート

このプロジェクトは macOS で開発およびテストされていますが、REAPERがクロスプラットフォームで一貫したサポートを提供しているため、WindowsとLinuxでも最小限の適応で動作するはずです。

要件

• REAPER 6.83+（組み込みLua 5.4と完全なReaScript APIを含む）
• Python 3.10+（MCP 1.1.2+に必要）
• LuaSocketライブラリ（オプション - ソケットベースの通信にのみ必要）

アーキテクチャ

このプロジェクトはLuaとPythonを組み合わせたハイブリッドアプローチを使用しています：

• Luaブリッジ：REAPER内で実行され、REAPERの組み込みLuaインタープリターを使用してAPI呼び出しを処理します。
• Python MCPサーバー：MCPインターフェースを提供し、ファイルベースのIPCを介してREAPERと通信します。

通信フロー：

1. MCPクライアントがリクエストを送信 → Pythonサーバー
2. PythonサーバーがJSONファイルを書き込む → ブリッジディレクトリ
3. Luaブリッジがファイルを読み込む → REAPER APIを実行
4. Luaブリッジがレスポンスを書き込む → ブリッジディレクトリ
5. Pythonサーバーがレスポンスを読み込む → MCPクライアントに返す

利用可能なツール

REAPER MCP Serverは、40以上のカテゴリにわたる 756のツール を実装しています。

コアDAW機能

• トラック管理と制御
• メディアアイテムとテイク
• MIDI操作
• エフェクト/FX管理
• オートメーションとエンベロープ
• プロジェクト管理
• トランスポートと再生

音楽制作ツール

• ループと時間選択管理：ループポイント、時間選択、グリッド量子化
• バウンスとレンダリング操作：トラックバウンス、フリーズ、ステムエクスポート
• グルーヴと量子化：ヒューマナイゼーション、スイング、ポリリズム、テンポ検出
• バスルーティングとミキシング：サブミックス、パラレルコンプレッション、サイドチェーンルーティング

高度な機能

• オーディオ分析とピーク検出
• ビデオとビジュアルメディアサポート
• カラー管理
• レイアウトとスクリーンセット管理
• スクリプト拡張サポート
• その他多数

すべての実装されたメソッドの完全なリストについては、IMPLEMENTATION_MASTER.md を参照してください。

通信フロー

ファイルベース (推奨)

1. MCPクライアント → MCPサーバー (stdio)
2. MCPサーバー → REAPER Luaブリッジ (JSONファイルを介して)
3. LuaブリッジがREAPER API呼び出しを実行
4. Luaブリッジ → MCPサーバー (JSONファイルを介して)
5. MCPサーバー → MCPクライアント (stdio)

ソケットベース

1. MCPクライアント → MCPサーバー (stdio)
2. MCPサーバー → REAPER Luaブリッジ (UDPポート9000)
3. LuaブリッジがREAPER API呼び出しを実行
4. Luaブリッジ → MCPサーバー (UDPポート9001)
5. MCPサーバー → MCPクライアント (stdio)

アンインストール

./scripts/uninstall.sh

REAPERについて

REAPER は、コンピュータ用の完全なデジタルオーディオ制作アプリケーションで、フルマルチトラックオーディオとMIDIの録音、編集、処理、ミキシング、マスタリングツールセットを提供します。REAPERはWindows、macOS、Linuxをサポートし、すべてのプラットフォームで一貫した機能を提供します。

APIリファレンス

このプロジェクトは、REAPER ReaScript API のサブセットを実装しています。ReaScript APIは、REAPERの機能を包括的に制御するためのAPIで、以下の機能を含みます：

• トラック管理とルーティング
• メディアアイテムとテイク
• MIDI編集
• エンベロープとオートメーション
• エフェクトとプラグイン
• プロジェクト管理
• トランスポート制御
• その他多数

現在実装されているメソッドの詳細については、IMPLEMENTATION_MASTER.md を参照してください。

🔧 技術詳細

このセクションでは、REAPER MCP Serverの技術的な詳細について説明します。アーキテクチャ、通信プロトコル、依存関係などの詳細を解説します。

📄 ライセンス

本プロジェクトのライセンスに関する情報は、原READMEに記載がないため省略しています。

貢献方法

新しいReaScriptメソッドを追加する際は、以下の手順に従ってください：

1. IMPLEMENTATION_MASTER.mdの実装チェックリストを確認します。
2. コードベースの既存のパターンに従います。
3. すべての新しいメソッドにテストを含めます。
4. 実装マスターリストを更新します。

テスト

以下の条件を満たしていることを確認してください：

1. REAPERが起動し、mcp_bridge_file_v2.luaが読み込まれていること。
2. MCPサーバーが起動していること (python -m server.app)。

その後、テストを実行します：

pytest tests/ -v

注意：一部のテストはタイミングの問題や出力形式のわずかな違いにより失敗する場合があります。コア機能は正しく動作することが検証されています。

特に統合テストを実行する場合は：

pytest tests/test_integration.py -v