Skip to content
Back to search

renderdoc-mcp

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jiaboli-github--renderdoc-mcp/badge.svg)](/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)

  1. <p align="center">
  2. <img src="docs/logo.png" alt="renderdoc-mcp" width="400"><br>
  3. <b>AI-native GPU frame debugging for RenderDoc</b><br><br>
  4. <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>
  5. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a><br>
  6. <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>
  7. <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>
  8. <b>English</b> | <a href="README-CN.md">简体中文</a>
  9. </p>
  10. ---
  11. 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.
  12. ## Demo
  13. <p align="center">
  14. <img src="docs/demo/demo-en.png" alt="Demo" width="600">
  15. </p>
  16. ## Features
  17. | Area | What you can do |
  18. |------|----------------|
  19. | Session & Capture | Open captures, live-capture frames, inspect metadata |
  20. | Frame Navigation | List events/draws, jump to any event |
  21. | Pipeline & Shaders | Inspect pipeline state, bindings, shader source, constant buffers |
  22. | Resources & Passes | Analyze frame structure, pass dependencies, resource usage |
  23. | Pixel & Shader Debug | Pixel history, pick pixel, debug pixel/vertex/thread |
  24. | Export | Render targets, textures, buffers, meshes, snapshots |
  25. | Diff & Assertions | Compare captures, assert pixels/state/images for CI |
  26. ## Download
  27. Get the latest package from [GitHub Releases](https://github.com/JiaboLi-GitHub/renderdoc-mcp/releases). The zip contains:
  28. | File | Description |
  29. |------|-------------|
  30. | `bin/renderdoc-mcp.exe` | MCP server (stdio) |
  31. | `bin/renderdoc-cli.exe` | CLI for shell & CI |
  32. | `bin/renderdoc.dll` / `renderdoc.json` | Bundled RenderDoc runtime |
  33. | `skills/renderdoc-mcp/` | Codex workflow skill |
  34. | `install-codex.ps1` | One-click Codex Desktop installer |
  35. ## Client Configuration
  36. ### Codex Desktop
  37. The installer auto-configures `~/.codex/config.toml`. Or add manually:
  38. ```toml
  39. [mcp_servers.renderdoc-mcp]
  40. command = 'renderdoc-mcp.exe'
  41. args = []
  42. ```
  43. ### Claude Code
  44. ```json
  45. {
  46. "mcpServers": {
  47. "renderdoc-mcp": {
  48. "command": "renderdoc-mcp.exe",
  49. "args": []
  50. }
  51. }
  52. }
  53. ```
  54. ## Build From Source
  55. ```bash
  56. cmake -B build -DRENDERDOC_DIR=<path-to-renderdoc-source>
  57. cmake --build build --config Release
  58. ```
  59. | Variable | Required | Description |
  60. |----------|----------|-------------|
  61. | `RENDERDOC_DIR` | Yes | RenderDoc source root |
  62. | `RENDERDOC_BUILD_DIR` | No | RenderDoc build output (if non-standard location) |
  63. ## Architecture
  64. ![Architecture](docs/architecture.png)
  65. ## License
  66. [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 in

Free to use. If it’s helped, pass it on.