使用说明
AI-native GPU frame debugging for RenderDoc
English | 简体中文
renderdoc-mcp是一个mcp服务器和CLI，它将renderdoc重播API封装到 59种结构化工具，让AI助手（Claude、Codex等）打开 .rdc 捕获、检查GPU帧、调试着色器/像素、比较捕获和导出证据——所有这些都不需要手动UI。
演示
特性
| 区域 | 你能做什么 |
|---|---|
| 会话和捕获 | 打开捕获、实时捕获帧、检查元数据 |
| 框架导航 | 列出事件/绘图，跳转到任何事件 |
| 管道和着色器 | 检查管道状态、绑定、着色器源、常量缓冲区 |
| 资源和通行证 | 分析帧结构、通行证依赖关系、资源使用情况 |
| 像素和着色器调试 | 像素历史、拾取像素、调试像素/顶点/线程 |
| 导出 | 渲染目标、纹理、缓冲区、网格、快照 |
| 差异和断言 | 比较捕获，断言CI的像素/状态/图像 |
下载
从获取最新包 GitHub 发布。该zip包含：
| 文件 | 描述 |
|---|---|
bin/renderdoc-mcp.exe |
MCP服务器（stdio） |
bin/renderdoc-cli.exe |
用于shell和CI的CLI |
bin/renderdoc.dll / renderdoc.json |
捆绑RenderDoc运行时 |
skills/renderdoc-mcp/ |
Codex工作流程技能 |
install-codex.ps1 |
一键式Codex桌面安装程序 |
客户端配置
Codex桌面
安装程序自动配置 ~/.codex/config.toml。或手动添加：
[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
| 变量 | 必填 | 描述 |
|---|---|---|
RENDERDOC_DIR |
是 | RenderDoc源根目录 |
RENDERDOC_BUILD_DIR |
否 | RenderDoc生成输出（如果位置不标准） |
