RenderDoc MCP Server

Ein MCP-Server, der als RenderDoc-UI-Erweiterung fungiert. Er ermöglicht KI-Assistenten den Zugriff auf RenderDoc-Capturedaten und unterstützt die Grafikdebugging.

Architektur

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

Da das in RenderDoc integrierte Python kein Socket-Modul enthält, wird die Kommunikation über dateibasierte IPC durchgeführt.

Related MCP server: RenderDoc MCP Server

Einrichtung

1. Installation der RenderDoc-Erweiterung

python scripts/install_extension.py

Die Erweiterung wird unter %APPDATA%\qrenderdoc\extensions\renderdoc_mcp_bridge installiert.

2. Aktivieren der Erweiterung in RenderDoc

1. RenderDoc starten

2. Tools > Manage Extensions

3. „RenderDoc MCP Bridge“ aktivieren

3. Installation des MCP-Servers

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

Nach einem Neustart der Shell ist der Befehl renderdoc-mcp verfügbar.

Hinweis: Mit --editable werden Änderungen am Quellcode sofort übernommen (praktisch während der Entwicklung). Für eine stabile Installation verwenden Sie uv tool install ..

4. Konfiguration des MCP-Clients

Claude Desktop

Zu claude_desktop_config.json hinzufügen:

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

Claude Code

Zu .mcp.json hinzufügen:

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

Verwendung

1. RenderDoc starten und eine Capturedatei (.rdc) öffnen

2. Über den MCP-Client (z. B. Claude) auf die RenderDoc-Daten zugreifen

Liste der MCP-Tools

Beispiele

Abrufen der Draw-Call-Liste

get_draw_calls(include_children=true)

Abrufen von Shader-Informationen

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

Abrufen des Pipeline-Zustands

get_pipeline_state(event_id=123)

Abrufen von Texturdaten

# 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)

Teilweises Abrufen von Pufferdaten

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

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

Anforderungen

• Python 3.10+

• uv

• RenderDoc 1.20+

Hinweis: Die Funktionsprüfung wurde nur unter Windows + DirectX 11 durchgeführt. Unter Linux/macOS + Vulkan/OpenGL ist die Funktion möglicherweise ebenfalls gegeben, wurde aber nicht verifiziert.

Lizenz

MIT