RenderDoc MCP Server 详细分析报告

1
┌─────────────┐     stdio      ┌──────────────────┐    文件IPC     ┌──────────────────┐
2
│  AI / IDE   │ ◄────────────► │  MCP Server      │ ◄────────────► │  RenderDoc 扩展  │
3
│ (WorkBuddy) │                │  (Python 3.10+)  │                │  (Python 3.6)    │
4
│             │                │  server.py       │                │  __init__.py     │
5
└─────────────┘                └──────────────────┘                └──────────────────┘
6
                                       │                                    │
7
                                  37 个 MCP 工具                    pyrenderdoc API
8
                                                                   (renderdoc.dll)

1
renderdoc-mcp/
2
├── pyproject.toml          # 项目配置（v1.6.0, Python ≥3.10, 依赖 mcp[cli]）
3
├── src/
4
│   ├── server.py           # MCP 工具注册（37 个工具，基于 FastMCP）
5
│   ├── ipc_client.py       # 文件 IPC 客户端（timeout=30s）
6
│   └── rd_wrapper.py       # RenderDoc API 直连封装（备用方案）
7
│
8
RenderDoc 扩展（单独安装）：
9
  %APPDATA%/qrenderdoc/extensions/renderdoc_mcp_bridge/__init__.py
10
  (~3400 行，执行 GPU 命令，通过 IPC 返回结果)

1
{
2
  "shaders": {
3
    "vertex": {"shaderId": 21878, "textureCount": 0, "cbufferCount": 3},
4
    "fragment": {"shaderId": 21879, "textureCount": 2, "cbufferCount": 3}
5
  },
6
  "renderTargets": [17568, 29581, 29566, 29560, 29563],
7
  "depthTarget": 29575
8
}

1
output_dir/
2
├── mesh_name.obj              # OBJ 模型
3
├── mesh_name.fbx              # FBX 7.4 ASCII（Unity/Unreal/Blender 通用）
4
├── mesh_name_material.json    # Unity 材质定义（属性映射 Standard/URP/HDRP）
5
├── mesh_name_UnityImport.cs   # C# 编辑器脚本（一键导入+自动赋材质）
6
└── mesh_name_unity_export.json # 完整导出摘要

1
SetFrameEvent(eid_66) → SaveTexture(RT) → 只有脸（眼眶镂空）→ 头部皮肤
2
SetFrameEvent(eid_73) → SaveTexture(RT) → 红色虹膜填入       → 眼球 ✅
3
SetFrameEvent(eid_87) → SaveTexture(RT) → 黑色发丝出现       → 头发

1
1. enumerate_counters()
2
   → 查看 GPU 支持的性能计数器列表
3

4
2. fetch_counters("1,2,3")
5
   → 获取每个 DrawCall 的 GPU 耗时、像素着色器调用次数等
6

7
3. get_action_timings()
8
   → 按 Marker 分组的 GPU 时间分析
9

10
4. 定位到耗时最高的 DrawCall：
11
   → reverse_shader(eid, "fragment")
12
   → 分析 Shader 复杂度
13
   → get_bound_textures() 查看纹理分辨率

1
1. pixel_history(rt_id, 400, 300)
2
   → 查看该像素被哪些 DrawCall 修改过
3
   → 定位到问题 DrawCall
4

5
2. set_event(问题 eid)
6
   → 定位到该事件
7

8
3. debug_pixel(400, 300)
9
   → 逐步跟踪像素着色器执行
10
   → 查看每步变量值，定位逻辑错误