RenderDoc MCP Server

Servidor MCP que funciona como extensión de la interfaz de RenderDoc. Permite que los asistentes de IA accedan a los datos de captura de RenderDoc y ayuden en la depuración de gráficos.

Arquitectura

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

Dado que el Python integrado en RenderDoc no tiene el módulo socket, la comunicación se realiza mediante IPC basado en archivos.

Related MCP server: RenderDoc MCP Server

Configuración

1. Instalación de la extensión de RenderDoc

python scripts/install_extension.py

La extensión se instala en %APPDATA%\qrenderdoc\extensions\renderdoc_mcp_bridge.

2. Habilitar la extensión en RenderDoc

1. Iniciar RenderDoc

2. Tools > Manage Extensions

3. Habilitar "RenderDoc MCP Bridge"

3. Instalación del servidor MCP

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

Al reiniciar el shell, el comando renderdoc-mcp estará disponible.

Nota: Con --editable, los cambios en el código fuente se reflejan inmediatamente (útil durante el desarrollo). Para instalar como versión estable, use uv tool install ..

4. Configuración del cliente MCP

Claude Desktop

Añadir a claude_desktop_config.json:

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

Claude Code

Añadir a .mcp.json:

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

Uso

1. Iniciar RenderDoc y abrir un archivo de captura (.rdc)

2. Acceder a los datos de RenderDoc desde el cliente MCP (Claude, etc.)

Lista de herramientas MCP

Ejemplos de uso

Obtener la lista de draw calls

get_draw_calls(include_children=true)

Obtener información del shader

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

Obtener el estado del pipeline

get_pipeline_state(event_id=123)

Obtener datos de textura

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

Obtener parcialmente datos del buffer

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

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

Requisitos

• Python 3.10+

• uv

• RenderDoc 1.20+

Nota: Solo se ha probado en entornos Windows + DirectX 11. Es posible que funcione en entornos Linux/macOS + Vulkan/OpenGL, pero no se ha verificado.

Licencia

MIT