renderdoc-mcp

MCP-сервер и CLI для RenderDoc: агент открывает дампы GPU-кадров и разбирает вызовы отрисовки, шейдеры и пиксели

373 ★ репозитория
Последний коммит 19 мая 2026
MIT

jiaboli-github/renderdoc-mcpАвтор:JiaboLi

Установка

Работает в: Codex
Claude Code
SourceCraft
Koda
Coddy

Ручная установка

{
  "mcpServers": {
    "renderdoc-mcp": {
      "command": "renderdoc-mcp.exe",
      "args": []
    }
  }
}

Путь к renderdoc-mcp.exe укажите полностью, если папка bin не лежит в PATH.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Сервер запускает .exe с библиотекой RenderDoc и читает файлы захватов на вашем компьютере
Экспорт записывает текстуры, буферы и меши на диск, а живой захват перехватывает запущенное приложение

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

renderdoc-mcp оборачивает API воспроизведения RenderDoc в 59 структурированных инструментов. Агент открывает файлы .rdc, листает события и вызовы отрисовки и читает состояние конвейера вместе с шейдерами. Открывать интерфейс RenderDoc вручную для этого не придется. Кадр можно захватить и вживую. Экспорт выдает цели рендеринга, текстуры, буферы и меши как доказательства для отчета. Сравнение двух захватов и проверки пикселей позволяют встроить контроль графики в сборку. Сервер работает по stdio, а рядом идет CLI renderdoc-cli для оболочки и CI. В архиве релиза лежит и скилл renderdoc-mcp для Codex.

Для кого. Для графических программистов и тестировщиков игр и 3D-приложений, которые хотят доверить агенту разбор кадров в RenderDoc.

Подходит, если

Кадр рисуется неправильно, и нужно найти вызов отрисовки, который испортил пиксель
Нужно сравнить два захвата до и после правки и показать, где изменилось состояние
Требуется вытащить шейдер, константные буферы и привязки конкретного вызова
Нужны автоматические проверки пикселей и состояния в CI для графического теста
Нужно экспортировать цель рендеринга, текстуру или меш как доказательство для баг-репорта

Не подходит, если

Нужно управлять игровым движком: для Unity, Godot и Unreal есть свои MCP-серверы
Нужен профайлинг производительности GPU: сервер читает захваты и состояние, он не заменяет профайлер
Вы работаете не на Windows и не готовы собирать из исходников: готовые сборки в релизах для Windows
Нет дампов .rdc и приложения, которое можно захватить

Пример запроса к агенту

Открой capture.rdc, найди вызов отрисовки, который закрасил пиксель (512, 300) красным, и покажи состояние конвейера и шейдер

MCP

Транспорт: stdio
Авторизация: не нужна

Ограничения

Готовый архив из GitHub Releases содержит файлы .exe для Windows: renderdoc-mcp.exe, renderdoc-cli.exe, библиотеку renderdoc.dll с renderdoc.json и установщик install-codex.ps1 для Codex Desktop. Для другой платформы сервер собирают из исходников через CMake, указав каталог исходного кода RenderDoc в переменной RENDERDOC_DIR, а при нестандартном месте сборки RenderDoc еще RENDERDOC_BUILD_DIR.

Сам RenderDoc распространяется по собственной лицензии, отдельной от MIT этого проекта.

Как отключить. Удалите запись renderdoc-mcp из конфигурации клиента: секцию [mcp_servers.renderdoc-mcp] в ~/.codex/config.toml для Codex или объект renderdoc-mcp в mcpServers для Claude Code. Затем удалите распакованную папку с файлами .exe.

Частые вопросы

Как подключить renderdoc-mcp к Claude Code?

Скачайте архив из GitHub Releases, распакуйте и добавьте в mcpServers запись renderdoc-mcp с command renderdoc-mcp.exe и пустым args. После этого агент увидит инструменты RenderDoc.

Что лежит в архиве релиза?

Папка bin с renderdoc-mcp.exe (сервер на stdio), renderdoc-cli.exe (CLI для оболочки и CI) и библиотеками renderdoc.dll и renderdoc.json, папка skills/renderdoc-mcp со скиллом для Codex и установщик install-codex.ps1.

Какие задачи решают инструменты?

Открыть .rdc или сделать живой захват кадра, перейти к любому событию, посмотреть состояние конвейера, привязки, шейдеры и константные буферы, разобрать проходы и использование ресурсов, получить историю пикселя и отладить пиксель, вершину или поток, экспортировать цели рендеринга, текстуры, буферы и меши.

Можно ли использовать его в CI?

Да, для этого есть блок сравнения и проверок. Он сравнивает два захвата и подтверждает пиксели, состояние и изображения, а renderdoc-cli удобен для запуска из оболочки. Так можно ловить регрессии графики без ручного просмотра.

Как собрать сервер из исходников?

Выполните cmake -B build -DRENDERDOC_DIR=<путь к исходникам RenderDoc>, затем cmake --build build --config Release. Если сборка RenderDoc лежит не в стандартном месте, задайте RENDERDOC_BUILD_DIR. Исходники RenderDoc нужно взять отдельно.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

trace-mcp

MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов

MCP-серверРасширенный доступ198

Draw.io MCP server

MCP-сервер для draw.io: агент строит и правит диаграммы, работает со слоями, страницами и фигурами облачных провайдеров

MCP-серверРасширенный доступ1,5 тыс.

coding-tools-mcp

MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке

MCP-серверШирокий доступ1,2 тыс.

SDL-MCP

MCP-сервер строит граф символов репозитория и отдает агенту карточки, срезы и окна кода под бюджет контекста

MCP-серверРасширенный доступ496

Docs MCP Server

Grounded Docs MCP Server

Локальный MCP-сервер: индексирует документацию из сайтов, GitHub, npm, PyPI и файлов и дает агенту поиск по нужной версии

MCP-серверРасширенный доступ1,8 тыс.

MCP Server for WinDbg

MCP Server for WinDbg Crash Analysis

MCP-сервер, который отдает агенту отладчики Windows: разбор аварийных дампов, удаленная и ядерная отладка на естественном языке

MCP-серверРасширенный доступ1,6 тыс.

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
renderdoc-mcp (эта запись)	нет	не нужна	373
MCP for Unity	нет	не нужна	15 537	управляет редактором Unity: сцены, ассеты, скрипты; кадры GPU и шейдеры не разбирает
Ghidra MCP Server	нет	не нужна	5 976	разбирает бинарники через Ghidra; renderdoc-mcp читает дампы кадров GPU

Коротко о README

Возможности сведены в таблицу по семи областям, от навигации по кадру до проверок для CI. Отдельно разобраны конфигурация Codex Desktop и Claude Code и сборка из исходников, архитектура показана схемой.

Бейдж для README

Сообщить о проблеме