Skip to content

README-CN.md

Latest commit

 

History

History
86 lines (64 loc) · 2.72 KB

README-CN.md

File metadata and controls

86 lines (64 loc) · 2.72 KB

renderdoc-mcp
面向 AI 的 RenderDoc GPU 帧调试工具

Release License: MIT
English | 简体中文

renderdoc-mcp 是一个基于 RenderDoc Replay API 的 MCP Server 和 CLI，提供 59 个结构化工具，让 AI 助手（Claude、Codex 等）可以直接打开 .rdc 抓帧、分析 GPU 帧、调试 Shader/像素、对比抓帧、导出证据 — 无需手动操作 UI。

演示

演示

功能概览

模块 能力
会话与抓帧 打开抓帧、实时抓帧、查看元信息
帧导航 列出事件/draw call、跳转到任意事件
管线与 Shader 查看管线状态、绑定、Shader 源码、常量缓冲区
资源与 Pass 分析帧结构、pass 依赖、资源使用情况
像素与 Shader 调试 像素历史、拾取像素、调试像素/顶点/线程
导出 渲染目标、纹理、Buffer、Mesh、快照
Diff 与断言 对比两次抓帧，断言像素/状态/图片用于 CI

下载

从 GitHub Releases 获取最新发布包。压缩包内容：

文件 说明
bin/renderdoc-mcp.exe MCP Server（stdio）
bin/renderdoc-cli.exe CLI，用于 Shell 和 CI
bin/renderdoc.dll / renderdoc.json 内置的 RenderDoc 运行时
skills/renderdoc-mcp/ Codex 工作流 skill
install-codex.ps1 Codex Desktop 一键安装脚本

客户端配置

Codex Desktop

安装脚本会自动配置 ~/.codex/config.toml。也可手动添加：

[mcp_servers.renderdoc-mcp]
command = 'renderdoc-mcp.exe'
args = []

Claude Code

{
  "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 构建输出目录（非默认位置时使用）

架构

架构

开源协议

MIT。RenderDoc 本身遵循其上游许可证。