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 для секретов.
Настройка клиентов
{
"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 для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
Unreal_mcp
Управление Unreal Engine: просмотр и импорт ассетов, работа с уровнями и секвенциями.