MCP Server for WinDbg
MCP Server for WinDbg Crash Analysis
MCP-сервер, который отдает агенту отладчики Windows: разбор аварийных дампов, удаленная и ядерная отладка на естественном языке
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Выполняет произвольные команды отладчика на хосте и читает файлы дампов
- Подключается к живым процессам и ядру целевой машины
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-for-windbg-crash-analysisОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале
claude mcp add --transport stdio --env '_NT_SYMBOL_PATH=SRV*C:\Symbols*https://msdl.microsoft.com/download/symbols' mcp-windbg -- python -m mcp_windbgИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"mcp-windbg","type":"stdio","command":"python","args":["-m","mcp_windbg"],"env":{"_NT_SYMBOL_PATH":"SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"mcp-windbg": {
"type": "stdio",
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add mcp-windbg --env '_NT_SYMBOL_PATH=SRV*C:\Symbols*https://msdl.microsoft.com/download/symbols' -- python -m mcp_windbgИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.mcp-windbg]
command = "python"
args = ["-m", "mcp_windbg"]
env = { _NT_SYMBOL_PATH = "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols" }Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"mcp-windbg": {
"type": "local",
"command": [
"python",
"-m",
"mcp_windbg"
],
"environment": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"mcp-windbg": {
"command": "python",
"args": [
"-m",
"mcp_windbg"
],
"env": {
"_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Установи сервер в Claude Code: /plugin marketplace add svnscha/mcp-windbg, затем /plugin install mcp-windbg-uvx@mcp-windbg. Нужен uv. Как вариант поставь пакет: 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.
Другие способы из описания автора
/plugin marketplace add svnscha/mcp-windbg
/plugin install mcp-windbg-uvx@mcp-windbgПлагин запускает сервер через uvx, нужен uv. Отдельно можно поставить плагины mcp-windbg-skills и mcp-windbg-agents.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает штатные отладчики Windows cdb.exe и kd.exe и дает агенту выполнять реальные команды WinDbg, а затем разбирать вывод. Он открывает аварийные дампы .dmp, .mdmp и .hdmp и запускает автоматическую триажную сводку: !analyze -v, стеки, модули, потоки. Помимо дампов сервер подключается к живому пользовательскому процессу через cdb -server и к ядру цели через kd по KDNET, именованному каналу или последовательному порту. В открытой сессии агент может выполнить любую команду отладчика, kb, lm, !process, !heap и другие, вести несколько сессий сразу по идентификаторам, а медленную живую команду прервать через CTRL+BREAK. Есть массовый разбор папки с дампами и фильтр-скрипт, который вычищает секреты и персональные данные из аргументов и вывода до того, как они покинут машину.
Для кого. Для разработчиков на C и C++, инженеров по надежности и специалистов поддержки, которые разбирают крэши и зависания на Windows.
Подходит, если
- Есть аварийный дамп и нужно найти причину исключения и сбойный кадр стека
- Нужно подключиться к живому процессу и посмотреть состояние при зависании
- Нужна отладка ядра: драйверы, bugcheck, проблемы на старте системы
- Есть папка дампов и нужно найти общую сигнатуру
Не подходит, если
- Рабочая среда не Windows и нет доступных cdb.exe и kd.exe
- Нужен готовый автофикс, а не разбор и объяснение причины
Пример запроса к агенту
Разбери дамп C:\dumps\app.dmp, покажи стек вызовов и объясни это нарушение доступаОграничения
Работает только на Windows и требует установленные Debugging Tools for Windows или WinDbg, которые поставляют cdb.exe и kd.exe. Для символов нужен путь _NT_SYMBOL_PATH, обычно на сервер символов Microsoft. Установка через плагин требует uv, ручная установка пакета требует Python 3.10 или новее. В корпоративной среде, где заданы allowedMcpServers, серверы из плагинов могут молча пропускаться, автор советует регистрировать сервер вручную.
Как отключить. Если ставили плагин, удалите его через /plugin. Если регистрировали сервер вручную, выполните claude mcp remove mcp-windbg или уберите запись сервера из конфигурации клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| _NT_SYMBOL_PATH | Путь к символам, обычно на сервер символов Microsoft. Без символов разбор дампов менее информативен. |
Проверка безопасности
- Выполняет произвольные команды отладчика на хосте и читает файлы дампов
- Подключается к живым процессам и ядру целевой машины
Коротко о README
README описывает MCP-сервер, который связывает агента с отладчиками Windows для разбора аварийных дампов, удаленной отладки в пользовательском режиме и отладки ядра. Перечислены инструменты open_ и run_ для сессий cdb и kd, идентификаторы сессий, прерывание живой команды и массовый разбор дампов. Установка в Claude Code идет через плагины: сервер на uvx, а также отдельные плагины со скиллами и агентом crash-analyst. Для других клиентов ставится пакет mcp-windbg с PyPI и настраивается _NT_SYMBOL_PATH. Есть документация по сценариям и справочник команд. Лицензия MIT.
Частые вопросы
Это заменяет отладчик?
Нет. Это обертка над cdb.exe и kd.exe: агент запускает настоящие команды WinDbg и объясняет вывод, но сами отладчики нужно установить отдельно.
Можно ли работать с другой машины?
Да. Сервер запускается по stdio локально или как HTTP-сервис, которым управляют с другого компьютера.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything