MCP-сервер для анализа сбоев в WinDbg

MCP-сервер для анализа сбоев в WinDbg, проект сообщества (автор — svnscha). Анализ аварийных дампов Windows через WinDbg и CDB. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
svnscha
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

Выполняет произвольные команды отладчика, читает дампы памяти; используйте --filter-script для секретов.

Настройка клиентов

vscode
{
    "code": "{\n    \"servers\": {\n        \"mcp_windbg\": {\n            \"type\": \"stdio\",\n            \"command\": \"python\",\n            \"args\": [\"-m\", \"mcp_windbg\"],\n            \"env\": {\n                \"_NT_SYMBOL_PATH\": \"SRV*C:\\\\Symbols*https://msdl.microsoft.com/download/symbols\"\n            }\n        }\n    }\n}",
    "lang": "json",
    "notes": "Дословно из README; MCP: Open User Configuration",
    "verified": "docs"
}

Что умеет

MCP-сервер для анализа сбоев в WinDbg связывает ИИ-модели с отладчиками Windows. Это Python-обёртка над cdb.exe и kd.exe: модель выполняет настоящие команды отладчика и рассуждает над их выводом. Подходит для анализа аварийных дампов, удалённой отладки пользовательского режима и отладки ядра. Автор подчёркивает: это не волшебное автоисправление.

Возможности:

  • Анализ дампов — открывает .dmp, .mdmp и .hdmp и одним вызовом делает первичный разбор: !analyze -v, стеки, модули, потоки.
  • Удалённая отладка пользовательского режима — подключение к серверу cdb/WinDbg (-remote) по TCP, именованному каналу или COM.
  • Отладка ядра — подключение к цели (-k) по KDNET, именованному каналу или последовательному порту.
  • Любые команды WinDbg/KD — kb, !process 0 0, !heap, lm и другие по описанию на естественном языке.
  • Несколько сессий — у каждой свой ID. Медленная команда, превысившая тайм-аут, прерывается через CTRL+BREAK, и сессия синхронизируется заново.
  • Разбор множества дампов — поиск и сравнение дампов в папке.
  • Фильтры текста — скрипт --filter-script вырезает персональные данные и секреты из аргументов и вывода до того, как они покинут машину.
  • STDIO или HTTP — локально или как сервис для управления с другой машины.

Инструменты: list_dumps, open_cdb_dump, open_cdb_remote, open_kd_session, open_kd_dump, run_cdb_command, run_kd_command, close_cdb_session, close_kd_session, send_ctrl_break, wait_for_break.

Кому подойдёт

  • Разработчикам под Windows: поиск причины падения по дампу — исключение, сбойный кадр стека.
  • Разработчикам драйверов: разбор синих экранов и проблем загрузки через отладку ядра.
  • Службам поддержки: разбор папки с дампами и поиск общей сигнатуры.

Похожие серверы — в категории разработка.

Установка

Нужна Windows с Debugging Tools for Windows или WinDbg из Microsoft Store — в них есть cdb.exe и kd.exe, сервер находит их сам. Варианты: pip install mcp-windbg (Python 3.10+, запуск python -m mcp_windbg), плагин для Claude Code через uvx или подписанный mcp-windbg.exe из релизов, которому Python не нужен. Опции: --cdb-path, --kd-path, --symbols-path, --filter-script, --transport.

Подключение к клиентам

Команда и конфиг приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

pip install mcp-windbg
claude mcp add mcp-windbg -s user -e _NT_SYMBOL_PATH="SRV*C:\Symbols*https://msdl.microsoft.com/download/symbols" -- python -m mcp_windbg

В VS Code (GitHub Copilot) нажмите F1 и выберите MCP: Open User Configuration — сервер будет доступен во всех рабочих пространствах. В Claude Code можно поставить плагин: /plugin marketplace add svnscha/mcp-windbg, затем /plugin install mcp-windbg-uvx@mcp-windbg. Нужен uv. В корпоративной среде с allowedMcpServers автор советует регистрировать сервер вручную.

Проверка

Перезапустите клиент и попросите проанализировать дамп по пути на диске — сработает open_cdb_dump, и вы получите разбор с исключением и стеком.

Примеры задач

Проанализируй аварийный дамп C:\dumps\app.dmp и объясни причину падения.
Найди все дампы в C:\dumps и выдели общую сигнатуру сбоев.

Риски

Сервер выполняет произвольные команды отладчика, читает дампы памяти и может подключаться к работающим процессам и ядру удалённых машин. Дампы часто содержат пароли, ключи и персональные данные. Вывод отладчика уходит модели, поэтому для таких дампов используйте --filter-script. Закрытие сессии ядра возобновляет работу целевой машины.

Режим HTTP позволяет управлять отладчиком по сети — открывайте его только в доверенной сети. Для релизного mcp-windbg.exe проверьте подпись и сумму SHA256 по SHA256SUMS. Лицензия — MIT.

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

Чем проект отличается от официального WinDbg MCP?

Microsoft встроила MCP в WinDbg начиная с версии 1.2610.1001.0. Этот проект — независимая альтернатива: запускает cdb.exe/kd.exe без интерфейса и подходит для других MCP-клиентов, управления по HTTP и пакетного разбора дампов.

Нужен ли Python?

Не обязательно: в каждом релизе есть подписанный mcp-windbg.exe со встроенным интерпретатором. Для pip нужен Python 3.10+.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Unreal_mcp

Управление Unreal Engine: просмотр и импорт ассетов, работа с уровнями и секвенциями.

Риск: high Лицензия: MIT ★ 1 016

Источники