Reaper MCP Server

Reaper MCP サーバー

これは、Reaper のプロジェクトを Claude Desktop のような MCP クライアントに接続し、プロジェクトについて質問したり、ミキシングのフィードバックに役立つ包括的なオーディオ分析を得たりできる MCP サーバーです。

このサーバーは、設計上読み取り専用です。AI がプロジェクトを変更するためのツールは公開していません。すでに作成したものを理解し、改善方法を学ぶのに役立ちます。AI にアイデアを提案してもらい、ノブを調整して音楽にどのような影響があるか、実際に試して確かめることができます。

ツール

プロジェクトの検出と解析

• find_reaper_projects：設定ファイルで指定したディレクトリ内の Reaper プロジェクトをすべて検索します。

• parse_reaper_project：Reaper プロジェクトファイル（.RPP）を解析し、テンポ、トラック、FX チェーン、オーディオアイテムなどの詳細情報を返します。

  各トラックには、位置と識別情報（Reaper の表示順に対応する track_number、guid）、ルーティング（is_folder／folder_depth、main_send、receives、num_channels、midi_hardware_out）、ミキサーの状態（volume、pan、mute、solo）が含まれます。各アイテムには、position、length、start_offset、playrate、mute、フェード、すべてのテイクが含まれます。再生されるテイクがわかるよう、アクティブなテイクには印が付けられます。

  receives の各エントリには、送信元トラックのインデックスと名前が記載されます。これにより、実際に信号が流れているトラックと、残されたトラックを区別できます。main_send: false のトラックからはマスターに音声が送られず、その音声はそのトラックから受信しているトラックを通じてのみ聞こえます。

これらのツールは連携して動作します。特定の Reaper プロジェクトについて Claude に質問すると、まず find_reaper_projects ツールでプロジェクトを見つけ、次に parse_reaper_project ツールでプロジェクトを解析して質問に回答します。

インストール済み FX の検出

• list_installed_fx(plugin_type=None, search_query=None)：Reaper で使用できる、インストール済みの FX／プラグインをすべて一覧表示します。

  パラメーター：

  • plugin_type（任意）：プラグインの種類（VST2、VST3、AU、JS、CLAP）で絞り込みます
  • search_query（任意）：名前、メーカー、種類でプラグインを検索します

  **戻り値：**以下を含む、インストール済みプラグインの一覧：

  • プラグイン名
  • プラグインの種類（VST2、VST3、AU、JS、CLAP）
  • ファイルパス
  • メーカー（取得可能な場合）

  質問の例：

  • 「インストール済みのシンセプラグインを教えてください」
  • 「Waves のプラグインをすべて表示してください」
  • 「揺らぎのあるシンセを探しています。インストール済みのプラグインには、どんな選択肢がありますか？」
  • 「VST3 プラグインをすべて一覧表示してください」
  • 「リバーブプラグインはありますか？」
  • 「iZotope のプラグインを教えてください」
  • 「Audio Unit プラグインをすべて表示してください」

  **注：**このツールは、Reaper のプラグインキャッシュファイルをスキャンします。新しいプラグインをインストールしたばかりで、Reaper でまだスキャンしていない場合、結果には表示されません。新しいプラグインをスキャンするため、Reaper を開いてスキャンが完了するまでお待ちください。

オーディオ分析

• analyze_audio_files(project_path, track_filter=None, whole_file=False)：Reaper プロジェクト内のオーディオを分析し、ミキシングに関するフィードバックを提供します。

  パラメーター：

  • project_path（必須）：.RPP プロジェクトファイルへのパスです。--reaper-projects-dir の配下にある必要があります。
  • track_filter（任意）：トラック名で絞り込みます（例：「Vocal」と指定すると、ボーカルトラックのみを分析します）。
  • whole_file（任意）：各アイテムが再生する範囲だけでなく、ソースファイル全体を分析します。デフォルトではオフです。

  **戻り値：**以下を含む包括的なオーディオ分析結果です。

  • レベル分析：ピークレベル、RMS、クリッピングの検出、DC オフセット
  • 周波数分析：スペクトル重心、および各帯域が総エネルギーに占める割合
  • ステレオイメージング：ステレオ幅、位相コヒーレンス、モノ互換性
  • ダイナミックレンジとラウドネス：LUFS（ラウドネス規格）、トゥルーピーク、クレストファクター

  質問の例：

  • 「Rock Song プロジェクトのオーディオをすべて分析して」
  • 「ボーカルトラックにクリッピングがないか確認して」
  • 「ミックスの音量はストリーミングプラットフォーム向けとして大きすぎますか？」
  • 「ドラムトラックに位相の問題はありますか？」

  **測定内容：**デフォルトでは、各アイテムはソースの開始オフセット、長さ、再生レートを考慮し、実際に再生される範囲のみを分析します。ソースファイル全体は分析しません。同じ範囲は一度だけ分析され、再利用されるため、アレンジ内でアイテムが繰り返されていても測定は一度で済みます。MIDI アイテムにはオーディオソースがないため、エラーとして報告されず、skipped に表示されます。

  **周波数の数値は相対値です。**各帯域は、その範囲のスペクトルパワー合計に占める割合（および同じ割合の dB 値）として報告されます。絶対帯域エネルギーはクリップの長さに応じて変化するため、同じ素材でも長いファイルは短いファイルより数十 dB「大きく」見え、ファイル間の比較は意味をなさなくなります。

  **これらの数値は FX 適用前のものです。**分析ではディスク上のソースファイルを読み取るため、トラックの FX チェーンやフェーダーは反映されません。アンプシミュレーターや強い EQ を使っているトラックの場合、分析結果が示すのは実際に聞こえる音ではなく、生の DI 信号です。すべての応答には signal_stage: pre-fx と表示されます。

  警告のしきい値：

  • ピークが -0.3 dBFS を超える：クリッピングのリスクがあります
  • クリッピングが検出された：デジタル歪みが発生しています
  • 200～500 Hz が 500～2000 Hz より 10 dB を超えて高い：低中域がこもっています。スペクトル全体に対する各帯域の比較ではなく、この2つの帯域同士を比較することで、ベースパートがベースであるというだけで誤検出されないようにしています。
  • 平均サンプル値が 0.001 を超える：DC オフセットがあります
  • 位相コヒーレンスが 0.5 未満：位相キャンセルの問題があります
  • LUFS が -8 を超える：ストリーミング向けとして音量が大きすぎます（Spotify の目標値：-14 LUFS）
  • クレストファクターが 6 dB 未満：過度に圧縮されている可能性があります

  測定できない場合（400 ms 未満の範囲）、ラウドネスは代用値ではなく null として報告されます。50 ms 未満の範囲は測定されますが、警告の対象にはなりません。

プロジェクトから解析されたすべてのデータ構造を確認するには、src/reaper_mcp_server/reaper_dataclasses.py ファイルをご覧ください。

セットアップ

uv をインストールする必要があります。このリポジトリをクローンしたり、仮想環境を作成したりする必要はありません。uvx がサーバーを取得、ビルド、実行し、Python も独自に管理します。

1. Claude Desktop を設定する

カスタム MCP サーバー向けのClaude Desktop の設定手順に従い、setup/claude_desktop_config.json のサンプルを使用してください。

{
    "mcpServers": {
        "reaper": {
            "command": "/path/to/your/uv-installation/uvx",
            "args": [
                "--from",
                "git+https://github.com/dschuler36/reaper-mcp-server",
                "reaper-mcp-server",
                "--reaper-projects-dir",
                "/path/to/your/reaper/projects"
            ]
        }
    }
}

入力するパスは2つあります。

• uvx — uvx だけを指定せず、絶対パスを使用してください。Claude Desktop はシェルの PATH を引き継がないため、コマンド名だけでは起動に失敗します。which uvx を実行して場所を確認してください（通常は ~/.local/bin/uvx です）。
• --reaper-projects-dir — Reaper プロジェクトが格納されているディレクトリです。サーバーが開くのは、その配下にある .RPP ファイルのみです。

後で新しいコミットを取得するには、uvx --refresh --from git+https://github.com/dschuler36/reaper-mcp-server reaper-mcp-server --help を一度実行するか、uv キャッシュをクリアしてから Claude Desktop を再起動してください。

代わりに Claude Code を使用する

claude mcp add reaper -- \
  uvx --from git+https://github.com/dschuler36/reaper-mcp-server \
  reaper-mcp-server --reaper-projects-dir /path/to/your/reaper/projects

2. 起動と設定

• Claude Desktopを開きます
• チャットボックスの「＋」アイコンをクリックします
• 「コネクター」をクリックすると、「reaper」コネクターが有効になっていることを確認できます

3. 質問してみましょう！

• Reaperプロジェクトについて質問します
• 質問する際は、対象となるReaperプロジェクトの名前を必ず含めてください
• ツールボックスを展開すると、Claudeに渡される生のプロジェクトデータを確認できます

クローンから実行する

サーバーを変更する場合は、クローンして、作業コピーをClaudeに指定します。uv runは起動のたびにロックされた依存関係を同期するため、別途インストールする必要はありません。

git clone https://github.com/dschuler36/reaper-mcp-server
cd reaper-mcp-server
uv sync                       # optional — only needed for running tests
uv run --group dev pytest

次に、クローンからサーバーを実行するsetup/claude_desktop_config_local.jsonを使用します。

{
    "mcpServers": {
        "reaper": {
            "command": "/path/to/your/uv-installation/uv",
            "args": [
                "--directory",
                "/path/to/this/repo/reaper-mcp-server/",
                "run",
                "reaper-mcp-server",
                "--reaper-projects-dir",
                "/path/to/your/reaper/projects"
            ]
        }
    }
}