RV MCP サーバー

Claude などの AI アシスタントを、業界標準のメディアレビューアプリケーションである Autodesk/Tweak RV に接続する MCP (Model Context Protocol) サーバーです。再生制御、ショットの比較、カラーグレーディングの調整、レビューセッションの管理をすべて自然言語で行えます。

RV 内部にプラグインは不要です。RV の組み込みネットワークリスナーと remote-eval を介した Mu スクリプトを使用します。

要件

• OpenRV (または RV 2022.3.1 以降) — ネットワークモードが有効であること

• Python 3.10+

• uv パッケージマネージャー

クイックスタート

1. RV をネットワークモードで起動

RV → Networking → Enable Network から RV のネットワークを有効にします（デフォルトポートは 45124）。

またはコマンドラインから起動します：

rv -network -networkPort 45124

2. インストールと登録

Claude Code (CLI):

claude mcp add --scope user rv-mcp -- uv run --no-sync --directory /path/to/RV_MCP rv-mcp

注: --no-sync は、複数の Claude セッションが同じ MCP サーバーを共有する際のファイルロック競合を防ぎます。依存関係を変更した後は、手動で uv sync を実行してください。

Claude Desktop (~/.claude.json):

{
  "mcpServers": {
    "rv-mcp": {
      "command": "uv",
      "args": ["run", "--no-sync", "--directory", "/path/to/RV_MCP", "rv-mcp"]
    }
  }
}

環境変数 (オプション):

3. 使用方法

Claude にメディアの読み込み、再生制御、ショットの比較、色の調整などを依頼してください。サーバーが自然言語を RV コマンドに自動変換します。

アーキテクチャ

Claude (stdio/MCP) --> FastMCP Server --> RV Network Protocol (TCP:45124) --> RV

このサーバーは、RV の RvCommunicator に基づくカスタムプロトコルを使用して、RV との 永続的な TCP 接続 を維持します。主な設計上の決定事項：

• 永続的な接続: ソケット切断時に自動再接続

• スレッドセーフ: 同時ツール呼び出しのために threading.Lock を使用

• クリーンなシャットダウン: atexit ハンドラを介して DISCONNECT を送信（これがないと、RV は将来の接続を拒否します）

• Mu 文字列の処理: 戻り値は自動的にクォート解除およびエスケープ解除されます

プロトコルの流れ

1. Connect TCP to 127.0.0.1:45124
2. Send: NEWGREETING <len> rv-mcp rvController
3. Send: PINGPONGCONTROL 1 0          (disable heartbeat)
4. Recv: NEWGREETING <len> <rv-name>   (consume RV's greeting)
5. For each command:
   Send: MESSAGE <len> RETURNEVENT remote-eval * { require commands; <mu_code> }
   Recv: MESSAGE <len> RETURN <value>
6. On shutdown:
   Send: MESSAGE <len> DISCONNECT

OCIO カラーマネジメント

サーバーには OCIO v2 の完全なサポートが含まれています。$OCIO が設定されている場合、RV は DCC アプリ（3ds Max/Redshift、Nuke など）で使用されるディスプレイ変換と正確に一致させることができます。

自動設定

RV がメディアを読み込む際に OCIO を自動設定する rv_ocio_setup.py スクリプトが含まれています：

• EXR/HDR/TX ファイル はシーンリニア（scene_linear ロールを介した ACEScg）として自動検出されます

• ディスプレイ変換 は設定のデフォルト（例: sRGB / ACES 1.0 SDR-video）から設定されます

• EXR 内のクロマティシティメタデータ は、アクティブな設定のカラースペースと照合されます

インストールするには、rv_ocio_setup.py を RV のサポートパスにコピーしてください：

# Windows
copy rv_ocio_setup.py %APPDATA%\RV\Python\

# Linux/macOS
cp rv_ocio_setup.py ~/.rv/Python/

RV の組み込み ocio_source_setup パッケージが、このオーバーライドを自動的に検出して使用します。

MCP を介した手動 OCIO 設定

Redshift + RV のカラーマッチング

Redshift の OCIO 設定 ($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio) を使用する場合、そのファイルルールでは EXR が「Raw」としてマークされることに注意してください。rv_ocio_setup.py スクリプトは、浮動小数点形式をシーンリニアとして検出することでこれをオーバーライドし、Redshift のレンダービューと同様に RV で ACES トーンマッパーが適用されるようにします。

ツール (合計 47)

実行 (1)

OCIO (6)

再生 (17)

ソース (7)

比較 (4)

カラー (12)

使用例

フッテージの読み込みとレビュー

"Load the EXR sequence at /shots/sh010/comp/sh010_comp.1-100#.exr"
"Play it back at 24fps"
"Go to frame 50"
"Set in point at 20 and out point at 80"

2 つのバージョンの比較

"Load both /shots/sh010/comp_v1.mov and /shots/sh010/comp_v2.mov"
"Switch to stack view"
"Set composite to difference mode"
"Toggle the wipe to compare side by side"

色補正

"Apply CDL with slope [1.1, 0.95, 1.0] and saturation 1.2"
"Load the ACES LUT from /luts/sRGB.cube"
"Set exposure to 0.5"
"Show me the current color settings"

高度な操作 (raw Mu)

"Execute this Mu code: { require commands; let s = sources(); string(s.size()); }"

プロジェクト構造

RV_MCP/
├── pyproject.toml          # Package config, entry point, dependencies
├── README.md
├── .gitignore
└── src/
    ├── __init__.py
    ├── server.py           # FastMCP server + RvClient instantiation
    ├── rv_client.py        # Persistent TCP client (RV network protocol)
    └── tools/
        ├── __init__.py
        ├── execute.py      # execute_mu — raw Mu escape hatch
        ├── playback.py     # 17 playback/transport tools
        ├── sources.py      # 7 source & session tools
        ├── compare.py      # 4 view/compare tools
        ├── color.py        # 12 color/LUT/CDL tools
        └── ocio.py         # OCIO v2 color management tools

トラブルシューティング

「Could not connect to RV」

• RV が -network フラグ付きで実行されていることを確認してください

• ポート 45124 がファイアウォールでブロックされていないことを確認してください

• -networkPort 45124 を使用してポートを明示的に設定してください

クラッシュ後に RV が接続を拒否する

サーバーが DISCONNECT を送信せずに終了した場合、RV が新しい接続を拒否することがあります。RV を再起動して状態をクリアしてください。サーバーには、通常の動作下でこれを防ぐための atexit ハンドラが含まれています。

Mu コードのエラー

• コードブロックは常に { require commands; ... } で囲んでください

• Mu は if/then/else の両方の分岐を評価します — 存在しない可能性のあるノードへのプロパティアクセスは避けてください

• ファイルパスにはスラッシュを使用する必要があります。escape_mu_string() がこれを自動的に処理します

タイムアウトエラー

デフォルトのタイムアウトは 30 秒です。Mu コードの実行に時間がかかる場合（大きなシーケンスの読み込みなど）、タイムアウトする可能性があります。長時間かかる操作には execute_mu を使用し、小さなステップに分割することを検討してください。

開発

# Install dependencies
uv sync

# Run the server directly
uv run rv-mcp

# Run with debug logging
uv run python -m src.server

ライセンス

MIT