Back to search
renderdoc-mcp
MCP serverGitHub
An MCP server for RenderDoc: Empowering AI assistants to analyze GPU frame captures and debug graphics pipelines.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/jiaboli-github--renderdoc-mcp)HTML
<a href="/listings/jiaboli-github--renderdoc-mcp"><img src="/api/listings/jiaboli-github--renderdoc-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 88 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img src="docs/logo.png" alt="renderdoc-mcp" width="400"><br>
- <b>AI-native GPU frame debugging for RenderDoc</b><br><br>
- <a href="https://github.com/JiaboLi-GitHub/renderdoc-mcp/actions/workflows/release.yml"><img src="https://github.com/JiaboLi-GitHub/renderdoc-mcp/actions/workflows/release.yml/badge.svg" alt="Release"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a><br>
- <a href="https://oosmetrics.com/repo/JiaboLi-GitHub/renderdoc-mcp"><img src="https://api.oosmetrics.com/api/v1/badge/achievement/5ab44894-4c44-4fee-903d-9dd6f86d2d46.svg" alt="oosmetrics: Top 3 in Graphics by acceleration"></a>
- <a href="https://oosmetrics.com/repo/JiaboLi-GitHub/renderdoc-mcp"><img src="https://api.oosmetrics.com/api/v1/badge/achievement/90a5455c-2c8f-43c3-868d-61c5b0811f78.svg" alt="oosmetrics: Top 6 in Backend by acceleration"></a><br>
- <b>English</b> | <a href="README-CN.md">简体中文</a>
- </p>
- ---
- 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.
- ## Demo
- <p align="center">
- <img src="docs/demo/demo-en.png" alt="Demo" width="600">
- </p>
- ## Features
- | 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 |
- ## Download
- Get the latest package from [GitHub Releases](https://github.com/JiaboLi-GitHub/renderdoc-mcp/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 |
- ## Client Configuration
- ### Codex Desktop
- The installer auto-configures `~/.codex/config.toml`. Or add manually:
- ```toml
- [mcp_servers.renderdoc-mcp]
- command = 'renderdoc-mcp.exe'
- args = []
- ```
- ### Claude Code
- ```json
- {
- "mcpServers": {
- "renderdoc-mcp": {
- "command": "renderdoc-mcp.exe",
- "args": []
- }
- }
- }
- ```
- ## Build From Source
- ```bash
- 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) |
- ## Architecture
- 
- ## License
- [MIT](LICENSE). RenderDoc itself is under its [own license](https://github.com/baldurk/renderdoc/blob/v1.x/LICENSE.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.