RenderDocMCP CLAUDE.md

RenderDoc MCP Server

RenderDoc UI拡張機能として動作するMCPサーバー。AIアシスタントがRenderDocのキャプチャデータにアクセスし、DirectX 11/12のグラフィックスデバッグを支援する。

アーキテクチャ

ハイブリッドプロセス分離方式:

Claude/AI Client (stdio)
        │
        ▼
MCP Server Process (標準Python + FastMCP 2.0)
        │ File-based IPC (%TEMP%/renderdoc_mcp/)
        ▼
RenderDoc Process (Extension + File Polling)

プロジェクト構成

RenderDocMCP/
├── mcp_server/                        # MCPサーバー
│   ├── server.py                      # FastMCPエントリーポイント
│   ├── config.py                      # 設定
│   └── bridge/
│       └── client.py                  # ファイルベースIPCクライアント
│
├── renderdoc_extension/               # RenderDoc拡張機能
│   ├── __init__.py                    # register()/unregister()
│   ├── extension.json                 # マニフェスト
│   ├── socket_server.py               # ファイルベースIPCサーバー
│   ├── request_handler.py             # リクエスト処理
│   └── renderdoc_facade.py            # RenderDoc APIラッパー
│
└── scripts/
    └── install_extension.py           # 拡張機能インストール

MCPツール

ツール名	説明
list_captures	指定ディレクトリ内の.rdcファイル一覧を取得
open_capture	キャプチャファイルを開く（既存キャプチャは自動で閉じる）
get_capture_status	キャプチャ読込状態確認
get_draw_calls	ドローコール一覧（階層構造、フィルタリング対応）
get_frame_summary	フレーム全体の統計情報（ドローコール数、マーカー一覧等）
find_draws_by_shader	シェーダー名でドローコールを逆引き検索
find_draws_by_texture	テクスチャ名でドローコールを逆引き検索
find_draws_by_resource	リソースIDでドローコールを逆引き検索
get_draw_call_details	特定ドローコールの詳細
get_action_timings	アクションのGPU実行時間を取得
get_shader_info	シェーダーソース/定数バッファ
get_buffer_contents	バッファデータ取得（オフセット/長さ指定可）
get_texture_info	テクスチャメタデータ
get_texture_data	テクスチャピクセルデータ取得（mip/slice/3Dスライス対応）
get_pipeline_state	パイプライン状態全体

get_draw_calls フィルタリングオプション

get_draw_calls(
    include_children=True,      # 子アクションを含める
    marker_filter="Camera.Render",  # このマーカー配下のみ取得
    exclude_markers=["GUI.Repaint", "UIR.DrawChain"],  # 除外するマーカー
    event_id_min=7372,          # event_id範囲の開始
    event_id_max=7600,          # event_id範囲の終了
    only_actions=True,          # マーカーを除外（ドローコールのみ）
    flags_filter=["Drawcall", "Dispatch"],  # 特定フラグのみ
)