RenderDoc MCP Server

一个用于 RenderDoc 的 MCP (Model Context Protocol) 服务器，允许 AI 助手分析和检查 RDC 捕获文件。

功能

• 打开和分析 RDC 捕获文件
• 获取捕获的基本信息（API 类型、驱动、帧数等）
• 列出和搜索纹理资源
• 列出和搜索缓冲区资源
• 获取 Draw Call 列表和详情
• 查看着色器信息
• 获取像素数据

安装

前置要求

1. RenderDoc: 从 renderdoc.org 下载并安装
2. Python 3.10+: 确保已安装 Python 3.10 或更高版本

安装 MCP 服务器

# 克隆仓库
git clone https://github.com/yourusername/renderdoc-mcp.git
cd renderdoc-mcp

# 安装依赖
pip install -e .

配置 RenderDoc Python 模块

要使用原生 Python API（推荐），需要设置 PYTHONPATH 包含 RenderDoc 的 Python 模块路径：

Windows:

set PYTHONPATH=%PYTHONPATH%;C:\Program Files\RenderDoc\plugins\python

或者在环境变量中永久设置。

如果不设置，服务器会自动回退到使用 renderdoccmd 命令行工具。

配置 Claude Desktop

在 Claude Desktop 配置文件中添加：

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "renderdoc": {
      "command": "python",
      "args": ["-m", "renderdoc_mcp.server"],
      "env": {
        "PYTHONPATH": "C:\\Program Files\\RenderDoc\\plugins\\python"
      }
    }
  }
}

macOS/Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "renderdoc": {
      "command": "python",
      "args": ["-m", "renderdoc_mcp.server"],
      "env": {
        "PYTHONPATH": "/usr/share/renderdoc/plugins/python"
      }
    }
  }
}

可用工具

工具名称	描述
renderdoc_check_available	检查 RenderDoc 是否可用
renderdoc_open_capture	打开 RDC 捕获文件
renderdoc_close_capture	关闭当前捕获文件
renderdoc_get_capture_info	获取捕获的详细信息
renderdoc_get_textures	获取所有纹理列表
renderdoc_get_buffers	获取所有缓冲区列表
renderdoc_get_draw_calls	获取 Draw Call 列表
renderdoc_get_shader_info	获取着色器详细信息
renderdoc_get_pixel_data	获取指定位置的像素数据
renderdoc_get_texture_thumbnail	获取纹理缩略图
renderdoc_analyze_draw_call	分析特定 Draw Call
renderdoc_search_resources	搜索资源

使用示例

在 Claude Desktop 中，你可以这样使用：

请帮我分析 C:\captures\scene.rdc 这个捕获文件中的纹理资源

列出这个捕获中的所有 Draw Call

搜索名称包含 "normal" 的纹理

开发

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

许可证

MIT License