# MCP Server for WinDbg Crash Analysis

Подключает Claude Code к отладчикам CDB и KD для разбора дампов падений Windows, сессий ядра и удалённой отладки процессов без интерфейса WinDbg.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1632
- Автор: svnscha
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/svnscha/mcp-windbg
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/mcp-server-for-windbg-crash-analysis

## Что делает

Сервер работает как Python-обёртка над консольными утилитами `cdb.exe` и `kd.exe`. Модель получает набор инструментов для открытия пользовательских дампов (`.dmp`, `.mdmp`), дампов ядра (`MEMORY.DMP`), а также для выполнения команд вроде `!analyze -v` или `lm`. Это позволяет запрашивать анализ стека вызовов и модулей на обычном языке.

Каждая открытая сессия получает отдельный идентификатор. Благодаря этому можно параллельно исследовать несколько дампов памяти. Сервер умеет прерывать зависшие команды сигналом CTRL+BREAK при превышении таймаута, а дополнительный скрипт фильтрации позволяет очистить конфиденциальные данные перед передачей ответа модели.

Без установленного пакета Debugging Tools for Windows или приложения WinDbg из Microsoft Store сервер работать не сможет, поскольку он опирается на внешние бинарные файлы отладчиков. В отличие от встроенного решения Microsoft, проект запускается автономно через stdio или сетевой транспорт HTTP.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `CDB_PATH`, `_NT_SYMBOL_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env CDB_PATH=<CDB_PATH> --env _NT_SYMBOL_PATH=<_NT_SYMBOL_PATH> --transport stdio mcp-server-for-windbg-crash-analysis -- uvx mcp-windbg
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-windbg <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server-for-windbg-crash-analysis --env CDB_PATH=<CDB_PATH> --env _NT_SYMBOL_PATH=<_NT_SYMBOL_PATH> -- uvx mcp-windbg
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-windbg <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-for-windbg-crash-analysis": {
            "command": "uvx",
            "args": [
                "mcp-windbg"
            ],
            "env": {
                "CDB_PATH": "<CDB_PATH>",
                "_NT_SYMBOL_PATH": "<_NT_SYMBOL_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-windbg <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-for-windbg-crash-analysis": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-windbg"
            ],
            "env": {
                "CDB_PATH": "<CDB_PATH>",
                "_NT_SYMBOL_PATH": "<_NT_SYMBOL_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-windbg <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e CDB_PATH=<CDB_PATH> -e _NT_SYMBOL_PATH=<_NT_SYMBOL_PATH> mcp-server-for-windbg-crash-analysis uvx mcp-windbg
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-windbg <команда>

## Когда брать
- Разобрать аварийный дамп памяти после сбоя программы или синего экрана.
- Выполнить команды отладчика `cdb.exe` или `kd.exe` через диалог с моделью.
- Провести пакетную сортировку группы дампов в указанной директории.
- Подключиться к сессии отладки ядра Windows или удалённому процессу.

## Примеры запросов агенту
- Открой дамп crash.dmp в папке dumps и покажи причину падения через !analyze -v
- Выполни команду kb для активной сессии cdb и найди сбойный фрейм
- Найди все файлы .dmp в директории C:\Dumps и сгруппируй их по типу сбоя

## Похожие
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74559
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 9946
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6505
- [agent-device](https://affpapa.org/nevibecode/mcp/agent-device.md) — MCP-сервер · ★ 5149

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md