RenderDoc MCP Server

MCP-сервер, работающий как расширение UI RenderDoc. Позволяет AI-ассистентам получать доступ к данным захвата RenderDoc и помогать с отладкой графики.

Архитектура

Claude/AI Client (stdio)
        │
        ▼
MCP Server Process (Python + FastMCP 2.0)
        │ File-based IPC (%TEMP%/renderdoc_mcp/)
        ▼
RenderDoc Process (Extension)

Поскольку встроенный в RenderDoc Python не имеет модуля socket, связь осуществляется через файловый IPC.

Related MCP server: RenderDoc MCP Server

Настройка

1. Установка расширения RenderDoc

python scripts/install_extension.py

Расширение устанавливается в %APPDATA%\qrenderdoc\extensions\renderdoc_mcp_bridge.

2. Включение расширения в RenderDoc

1. Запустите RenderDoc

2. Tools > Manage Extensions

3. Включите "RenderDoc MCP Bridge"

3. Установка MCP-сервера

uv tool install
uv tool update-shell  # PATHに追加

После перезапуска оболочки команда renderdoc-mcp станет доступна.

Примечание: При использовании --editable изменения в исходном коде применяются немедленно (удобно при разработке). Для установки стабильной версии используйте uv tool install ..

4. Настройка MCP-клиента

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "renderdoc": {
      "command": "renderdoc-mcp"
    }
  }
}

Claude Code

Добавьте в .mcp.json:

{
  "mcpServers": {
    "renderdoc": {
      "command": "renderdoc-mcp"
    }
  }
}

Использование

1. Запустите RenderDoc и откройте файл захвата (.rdc)

2. Получите доступ к данным RenderDoc через MCP-клиент (например, Claude)

Список инструментов MCP

Примеры использования

Получение списка вызовов отрисовки

get_draw_calls(include_children=true)

Получение информации о шейдере

get_shader_info(event_id=123, stage="pixel")

Получение состояния конвейера

get_pipeline_state(event_id=123)

Получение данных текстуры

# 2Dテクスチャのmip 0を取得
get_texture_data(resource_id="ResourceId::123")

# 特定のmipレベルを取得
get_texture_data(resource_id="ResourceId::123", mip=2)

# キューブマップの特定の面を取得 (0=X+, 1=X-, 2=Y+, 3=Y-, 4=Z+, 5=Z-)
get_texture_data(resource_id="ResourceId::456", slice=3)

# 3Dテクスチャの特定の深度スライスを取得
get_texture_data(resource_id="ResourceId::789", depth_slice=5)

Частичное получение данных буфера

# バッファ全体を取得
get_buffer_contents(resource_id="ResourceId::123")

# オフセット256から512バイト取得
get_buffer_contents(resource_id="ResourceId::123", offset=256, length=512)

Требования

• Python 3.10+

• uv

• RenderDoc 1.20+

Примечание: Проверено только в среде Windows + DirectX 11. Возможна работа в средах Linux/macOS + Vulkan/OpenGL, но не проверено.

Лицензия

MIT