renderdoc-mcp

RenderDoc 的 MCP 服务器 —— 让 AI 助手直接分析 GPU 帧捕获文件（.rdc），用于图形调试和性能分析。

平台：Windows x64、Linux x64（含 WSL2）。 数据本地处理：.rdc 文件不离开本机，分析在本地 GPU 上回放完成。

前置条件

• uv — docs.astral.sh/uv/getting-started/installation

uvx 首次运行时会自动下载 Python 3.13 并创建隔离环境，无需手动安装 Python。

uv --version       # uv 0.x.x

配置

将以下内容添加到 MCP 客户端配置文件中，uvx 会自动下载并运行服务器：

{
  "command": "uvx",
  "args": ["--python", "3.13", "renderdoc-mcp"]
}

⚠️ --python 3.13 必须带上。 捆绑的 RenderDoc 模块仅编译给 Python 3.13，省略该参数会导致运行时 ABI 不匹配或导入失败。

VS Code（mcp.json）：

{
  "servers": {
    "renderdoc": {
      "command": "uvx",
      "args": ["--python", "3.13", "renderdoc-mcp"]
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "renderdoc": {
      "command": "uvx",
      "args": ["--python", "3.13", "renderdoc-mcp"]
    }
  }
}

使用方式

直接与 AI 助手对话：

"打开 frame.rdc，看看这一帧的渲染流程"

"找到渲染角色模型的 draw call，检查它的管线状态"

"为什么阴影贴图是黑的？检查深度 pass"

"分析性能，有没有冗余的 draw call 或状态切换？"

"这个材质反射不对，对比原始物体和反射 pass 的差异"

能做什么（按场景）

常见问题

ImportError: DLL load failed — 检查杀毒软件是否拦截了捆绑的 DLL。

服务器无法启动 — 查看 MCP 客户端日志；检查 uv 输出中的 Python 下载/安装信息。首次启动时 uv 会自动下载 Python 3.13，可能需要等待几分钟。

许可证

MIT