renderdoc-mcp

[](https://github.com/JiaboLi-GitHub/renderdoc-mcp/actions/workflows/release.yml) English | 中文

MCP (Model Context Protocol) server for GPU render debugging. Enables AI assistants (Claude, Codex, etc.) to analyze RenderDoc capture files (.rdc) through a standard MCP interface.

• 52 MCP tools covering the full GPU debugging workflow
• CLI tool (renderdoc-cli) for scripting and shell-based workflows
• Open and analyze .rdc capture files (D3D11 / D3D12 / OpenGL / Vulkan)
• Live capture: launch an application with RenderDoc injected, capture a frame, and auto-open it
• List draw calls, events, render passes with filtering
• Inspect pipeline state, shader bindings, resource details
• Get shader disassembly and reflection data, search across shaders
• Export textures, buffers, and render targets as PNG/binary
• Performance stats, debug/validation log messages
• Automatic parameter validation with proper JSON-RPC error codes
• Frame diff engine: compare two captures side-by-side — draw sequences, pipeline state, resources, per-pass stats, and pixel-level framebuffer diff
• Layered architecture: core library shared by MCP server, CLI, and AI skill

• Windows (MSVC compiler with C++17)
• CMake >= 3.16
• RenderDoc source code and build output (renderdoc.lib + renderdoc.dll)

Prebuilt Windows x64 binaries can be downloaded from the GitHub Releases page.

Each release zip includes:

Current package layout:

• bin/renderdoc-mcp.exe — MCP server
• bin/renderdoc-cli.exe — command-line tool
• bin/renderdoc.dll, bin/renderdoc.json, and the extra RenderDoc runtime DLLs needed beside the executables
• skills/renderdoc-mcp/ — Codex skill
• install-codex.ps1 — install the MCP server, skill, and CLI i