RenderDoc MCP Server

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

アーキテクチャ

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

RenderDoc内蔵のPythonにはsocketモジュールがないため、ファイルベースのIPCで通信を行う。

セットアップ

1. RenderDoc拡張機能のインストール

python scripts/install_extension.py

拡張機能は %APPDATA%\qrenderdoc\extensions\renderdoc_mcp_bridge にインストールされる。

2. RenderDocで拡張機能を有効化

1. RenderDocを起動
2. Tools > Manage Extensions
3. "RenderDoc MCP Bridge" を有効化

3. MCPサーバーのインストール

uv tool install
uv tool update-shell  # PATHに追加

シェルを再起動すると renderdoc-mcp コマンドが使えるようになる。

Note: --editable を付けると、ソースコードの変更が即座に反映される（開発時に便利）。 安定版としてインストールする場合は uv tool install . を使用。

4. MCPクライアントの設定

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "renderdoc": {
      "command": "renderdoc-mcp"
    }
  }
}

Claude Code

.mcp.json に追加:

{
  "mcpServers": {
    "renderdoc": {
      "command": "renderdoc-mcp"
    }
  }
}

使い方

1. RenderDocを起動し、キャプチャファイル (.rdc) を開く
2. MCPクライアント (Claude等) から RenderDoc のデータにアクセス

MCPツール一覧

ツール	説明
get_capture_status	キャプチャの読み込み状態を確認
get_draw_calls	ドローコール一覧を階層構造で取得
get_draw_call_details	特定のドローコールの詳細情報を取得
get_shader_info	シェーダーのソースコード・定数バッファの値を取得
get_buffer_contents	バッファの内容を取得 (Base64)
get_texture_info	テクスチャのメタデータを取得
get_texture_data	テクスチャのピクセルデータを取得 (Base64)
get_pipeline_state	パイプライン状態を取得

使用例

ドローコール一覧の取得

get_draw_calls(include_children=true)

シェーダー情報の取得

get_shader_info(event_id=123, stage="pixel")

パイプライン状態の取得

get_pipeline_state(event_id=123)

テクスチャデータの取得

# 2Dテクスチャのmip 0を取得
get_texture_data(resource_id="ResourceId::123")

# 特定のmipレベルを取得
get_texture_data(resource_id="ResourceId::123", mip=2)

# キューブマップの特定の面を取得 (0=X+, 1=X-, 2=Y+, 3=Y-, 4=Z+, 5=Z-)
get_texture_data(resource_id="ResourceId::456", slice=3)

# 3Dテクスチャの特定の深度スライスを取得
get_texture_data(resource_id="ResourceId::789", depth_slice=5)

バッファデータの部分取得

# バッファ全体を取得
get_buffer_contents(resource_id="ResourceId::123")

# オフセット256から512バイト取得
get_buffer_contents(resource_id="ResourceId::123", offset=256, length=512)

要件

• Python 3.10+
• uv
• RenderDoc 1.20+

Note: 動作確認はWindows + DirectX 11環境でのみ行っています。 Linux/macOS + Vulkan/OpenGL環境でも動作する可能性がありますが、未検証です。

ライセンス

MIT