An MCP server for RenderDoc: Empowering AI assistants to analyze GPU frame captures and debug graphics pipelines.
$ npx -y skills add JiaboLi-GitHub/renderdoc-mcp --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
renderdoc-mcp is an MCP server and CLI that wraps the RenderDoc replay API into 59 structured tools, letting AI assistants (Claude, Codex, etc.) open .rdc captures, inspect GPU frames, debug shaders/pixels, compare captures, and export evidence โ all without manual UI.
| Area | What you can do |
|---|---|
| Session & Capture | Open captures, live-capture frames, inspect metadata |
| Frame Navigation | List events/draws, jump to any event |
| Pipeline & Shaders | Inspect pipeline state, bindings, shader source, constant buffers |
| Resources & Passes | Analyze frame structure, pass dependencies, resource usage |
| Pixel & Shader Debug | Pixel history, pick pixel, debug pixel/vertex/thread |
| Export | Render targets, textures, buffers, meshes, snapshots |
| Diff & Assertions | Compare captures, assert pixels/state/images for CI |
Get the latest package from GitHub Releases. The zip contains:
| File | Description |
|---|---|
bin/renderdoc-mcp.exe | MCP server (stdio) |
bin/renderdoc-cli.exe | CLI for shell & CI |
bin/renderdoc.dll / renderdoc.json | Bundled RenderDoc runtime |
skills/renderdoc-mcp/ | Codex workflow skill |
install-codex.ps1 | One-click Codex Desktop installer |
The installer auto-configures ~/.codex/config.toml. Or add manually:
[mcp_servers.renderdoc-mcp]
command = 'renderdoc-mcp.exe'
args = []
{
"mcpServers": {
"renderdoc-mcp": {
"command": "renderdoc-mcp.exe",
"args": []
}
}
}
cmake -B build -DRENDERDOC_DIR=<path-to-renderdoc-source>
cmake --build build --config Release
| Variable | Required | Description |
|---|---|---|
RENDERDOC_DIR | Yes | RenderDoc source root |
RENDERDOC_BUILD_DIR | No | RenderDoc build output (if non-standard location) |

MIT. RenderDoc itself is under its own license.
.github/
workflows/
ci.yml
release.yml
.gitignore
CMakeLists.txt
docs/
architecture.png
demo/
demo-en.mp4
demo-en.png
demo.mp4
demo.png
vkcube-render-target.png
logo.png
superpowers/
plans/
2026-03-26-renderdoc-mcp-testing-implementation.md
2026-03-26-renderdoc-mcp-v1-implementation.md
2026-03-26-renderdoc-mcp-v2-development-plan.md
2026-03-31-capture-frame-implementation.md
2026-04-01-phase1-debug-tools.md
2026-04-01-phase2-shader-mesh-assert.md
2026-04-02-diff-engine.md
2026-04-02-phase4-pass-analysis.md
2026-04-09-validation-polish.md
specs/
2026-03-26-renderdoc-mcp-testing-design.md
2026-03-26-renderdoc-mcp-v1-design.md
2026-03-31-capture-frame-design.md
2026-04-01-phase1-debug-tools-design.md
2026-04-01-phase2-shader-mesh-assert-design.md
2026-04-02-diff-engine-design.md
2026-04-02-phase4-pass-analysis-design.md
2026-04-09-validation-polish-design.md
install-codex.ps1
LICENSE
README-CN.md
README.md
release-notes/
v0.1.0.md
v0.2.0.md
v0.2.1.md
v0.2.2.md
v0.3.0.md
renderdoc-version.txt
scripts/
package-release.ps1
smoke-test.ps1
validate-release-package.ps1
skills/
renderdoc-mcp/
agents/
openai.yaml
SKILL.md
src/
cli/
cli_parse.cpp
cli_parse.h
main.cpp
core/
action_helpers.cpp
action_helpers.h
assertions.cpp
assertions.h
capture.cpp
capture.h
cbuffer.cpp
cbuffer.h
constants.h
counters.cpp
counters.h
debug.cpp
debug.h
diff_alignment.cpp
diff_internal.h
diff_pipeline.cpp
diff_session.cpp
diff_session.h
diff_structure.cpp
diff_summary.cpp
diff.h
errors.cpp
errors.h
events.cpp
events.h
export.cpp
export.h
info.cpp
info.h
mesh.cpp
mesh.h
pass_analysis.cpp
pass_analysis.h
pipeline.cpp
pipeline.h
pixel.cpp
pixel.h
renderdoc_tostr_anchor.cpp
replay_marker.cpp
resource_id.h
resources.cpp
resources.h
session.cpp
session.h
shader_edit.cpp
shader_edit.h
shaders.cpp
shaders.h
snapshot.cpp
snapshot.h
stb_impl.cpp
texstats.cpp
texstats.h
types.h
usage.cpp
usage.h
main.cpp
mcp/
action_flags.cpp
mcp_server_default.cpp
mcp_server.cpp
mcp_server.h
serialization.cpp
serialization.h
tool_registry.cpp
tool_registry.h
tools/
assertion_tools.cpp
capture_tools.cpp
cbuffer_tools.cpp
counter_tools.cpp
debug_tools.cpp
diff_tools.cpp
event_tools.cpp
export_tools.cpp
info_tools.cpp
mesh_tools.cpp
pass_tools.cpp
pipeline_tools.cpp
pixel_tools.cpp
resource_tools.cpp
session_tools.cpp
shader_edit_tools.cpp
shader_tools.cpp
snapshot_tools.cpp
texstats_tools.cpp
tools.h
usage_tools.cpp
tests/
CMakeLists.txt
fixtures/
vkcube.rdc
integration/
test_capture.cpp
test_protocol.cpp
test_tools_diff.cpp
test_tools_phase1.cpp
test_tools_phase2.cpp
test_tools_phase4.cpp
test_tools.cpp
test_workflow.cpp
unit/
session_stub.cpp
test_cli_parse.cpp
test_diff_algo.cpp
test_mcp_server.cpp
test_pass_analysis.cpp
test_serialization.cpp
test_tool_registry.cpp
third_party/
stb_image_write.h
stb_image.hFAQ
renderdoc-mcp is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes renderdoc-mcp. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.