RenderDoc MCP Server

An MCP server that runs as a RenderDoc UI extension. It allows AI assistants to access RenderDoc capture data and assist with graphics debugging.

Architecture

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

Since RenderDoc's built-in Python does not include the socket module, communication is done via file-based IPC.

Related MCP server: RenderDoc MCP Server

Setup

1. Install the RenderDoc extension

python scripts/install_extension.py

The extension is installed to %APPDATA%\qrenderdoc\extensions\renderdoc_mcp_bridge.

2. Enable the extension in RenderDoc

1. Launch RenderDoc

2. Tools > Manage Extensions

3. Enable "RenderDoc MCP Bridge"

3. Install the MCP server

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

After restarting your shell, the renderdoc-mcp command becomes available.

Note: Adding --editable reflects source code changes immediately (useful during development). To install as a stable version, use uv tool install ..

4. Configure the MCP client

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

Add to .mcp.json:

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

Usage

1. Launch RenderDoc and open a capture file (.rdc)

2. Access RenderDoc data from an MCP client (such as Claude)

MCP tool list

Usage examples

Getting the draw call list

get_draw_calls(include_children=true)

Getting shader information

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

Getting pipeline state

get_pipeline_state(event_id=123)

Getting texture data

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

Getting partial buffer data

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

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

Requirements

• Python 3.10+

• uv

• RenderDoc 1.20+

Note: Operation has only been verified on Windows + DirectX 11. It may also work on Linux/macOS + Vulkan/OpenGL environments, but this has not been verified.

License

MIT