不用再手动翻事件列表了。配置好 renderdoc-mcp，直接用自然语言提问，AI 就能帮你查看 draw call、管线状态、shader 和资源。

renderdoc-mcp 是什么

RenderDoc 是图形开发者最常用的 GPU 抓帧调试工具，但分析一个抓帧往往需要在大量事件中反复点击、展开、对比。

renderdoc-mcp 是一个 MCP (Model Context Protocol) 服务器，让 Claude、Codex 等 AI 助手可以直接操作 RenderDoc，打开 .rdc 文件、检查 GPU 状态、导出渲染结果。你只需要用自然语言描述问题，AI 就会驱动 RenderDoc 帮你找到答案。

支持 D3D11、D3D12、OpenGL、Vulkan 四种图形 API 的抓帧文件。

第一步：下载

前往 GitHub Releases 下载最新版本的压缩包。

解压后你会看到：

renderdoc-mcp/
├── renderdoc-mcp.exe      # 主程序
├── renderdoc.dll           # RenderDoc 核心库
├── d3dcompiler_47.dll      # 运行时依赖
└── ...                     # 其他 DLL 和许可证文件

重要：所有文件必须放在同一个目录下，不要只拷贝 exe。

第二步：配置 MCP 客户端

选择你使用的 AI 客户端，按以下方式配置。

Claude Desktop

打开设置 → 开发者 → 编辑配置，在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "renderdoc": {
      "command": "C:/your/path/renderdoc-mcp.exe",
      "args": []
    }
  }
}

将路径替换为你实际的 renderdoc-mcp.exe 位置。保存后重启 Claude Desktop。

Claude Code

在终端中运行：

claude mcp add renderdoc -- C:/your/path/renderdoc-mcp.exe

或者手动编辑 settings.json 添加同样的配置。

其他 MCP 客户端（Codex、Cursor 等）

任何支持 stdio 传输的 MCP 客户端都可以使用。将命令指向 renderdoc-mcp.exe 的路径即可。

第三步：第一次对话

配置完成后，打开一个新对话，试试这样提问：

打开 D:/renderdoc/renderdoc-mcp/tests/fixtures/vkcube.rdc，里面有什么信息？

上面的路径指向仓库自带的样例抓帧文件。你也可以换成自己的 .rdc 文件路径。

AI 会自动调用 renderdoc-mcp 的工具来分析这个抓帧，并返回类似这样的结果：

我通过 renderdoc-mcp 检查了这个抓帧，先给你一个快速总结：
​
- 这是一个 Vulkan 抓帧，共有 6 个事件、1 个 draw call。
- 主要 draw call 是事件 11 的 vkCmdDraw()，绘制了 36 个索引，实例数为 1。
- 管线使用了顶点着色器 ResourceId::111 和片元着色器 ResourceId::112。
- 当前渲染目标格式为 R8G8B8A8_UNORM，viewport 大小为 500x500。
- VS 阶段绑定了常量缓冲区 ubuf，PS 阶段读取了纹理 tex。
- 调试/验证日志为空，没有报错。

背后 AI 实际调用了一连串工具：open_capture → get_capture_info → list_draws → goto_event → get_pipeline_state → get_bindings → get_log。

你还可以继续追问：

• "帮我把事件 11 的渲染结果导出成 PNG"

• "这个 draw call 的 shader 反汇编是什么？"

• "有哪些纹理资源？"

你可以问什么

以下是一些典型的提问方式，适合直接复制使用：

问题	说明
"打开 xxx.rdc，有哪些信息？"	全局概览
"列出所有 draw call"	查看绘制调用列表
"跳到事件 42，管线状态是什么？"	查看特定事件的管线
"当前片元阶段绑定了哪些纹理？"	查看 shader 资源绑定
"导出当前事件的 render target"	保存渲染结果为 PNG
"有没有验证层报错？"	检查调试日志
"事件 120 和 121 之间发生了什么变化？"	对比两个事件

常见问题

Q: 提示找不到 renderdoc.dll？

确保 renderdoc.dll 和 renderdoc-mcp.exe 在同一个目录下。不要只拷贝 exe 文件。

Q: 路径格式有要求吗？

使用绝对路径，正斜杠和反斜杠都可以：

• D:/captures/my_frame.rdc

• D:\captures\my_frame.rdc

Q: 可以同时打开多个抓帧吗？

目前一次只能打开一个抓帧。如果需要分析另一个文件，再调用 open_capture 即可，会自动关闭之前的。

Q: 支持哪些图形 API？

D3D11、D3D12、OpenGL、Vulkan 都支持。

下一步

现在你已经可以用 AI 分析 GPU 抓帧了。想了解如何用它来调试一个真实的渲染 bug？请看下一篇。