Skip to main content
Glama

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Hengle/Renderdoc-Mcp2'

If you have feedback or need assistance with the MCP directory API, please join our Discord server