MCP Server for WinDbg Crash Analysis

MCP Server for WinDbg Crash Analysis

svnschaMIT
1.3k звёзд126 форков
MCP-сервер, который соединяет языковые модели с WinDbg. Вы анализируете аварийные дампы Windows, не заучивая синтаксис десятков команд отладчика. Сервер — это обёртка на Python над CDB (консольной версией WinDbg). Модель сама выбирает нужные команды и объясняет результат. Для кого: разработчики Windows-приложений, системные инженеры, администраторы. Если вы разбираете краш-дампы вручную, сервер ускорит поиск причины ошибки. Вы просто пишете «Покажи стек вызовов в момент падения» — и получаете структурированный ответ. Сервер подходит и для живых сессий удалённой отладки. Это не магическое средство для автопочинки, а инструмент, который объединяет опыт LLM с мощью отладчика Windows.
Ai-ml
Открыть на GitHub

Установка

uvx mcp-windbg

Характеристики

Общее

  • СтатусСообщество
  • Разработчикsvnscha
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdiostreamable-http

Описание

Возможности

  • Анализ одиночных краш-дампов (.dmp). Отправляете файл — AI расшифровывает ошибку.
  • Массовый анализ директорий. Сервер сканирует все дампы в папке, ищет общие паттерны и группирует ошибки.
  • Подключение к удалённым отладчикам и сессиям живой отладки в реальном времени.
  • Выполнение любых команд WinDbg: k, !analyze -v, dd, dt, .exr. AI объясняет сырой вывод.
  • Настройка путей к символам (Symbol Server). Поддержка Microsoft Symbol Server и собственных серверов.
  • Гибкий таймаут сессий (--timeout). Полезно для глубокого анализа сложных дампов.
  • Выбор транспорта: stdio для локальных клиентов (Claude Desktop, VS Code) или streamable-http для веб-интеграции.
  • Режим многословия (--verbose) для отладки работы самого MCP-сервера.
  • Совместимость со всеми популярными MCP-клиентами: GitHub Copilot, Cline, Cursor, Windsurf.

Как подключить

Шаг 1. Установите зависимости: Python 3.10+ и Windows SDK с Debugging Tools for Windows (WinDbg/CDB).

Шаг 2. Установите пакет: pip install mcp-windbg или uvx mcp-windbg.

Шаг 3. Настройте клиент. Пример для Claude Desktop (файл claude_desktop_config.json):

{ "mcpServers": { "mcp-windbg": { "command": "uvx", "args": ["mcp-windbg", "--transport", "stdio"] } } }

Для работы по HTTP: uvx mcp-windbg --transport streamable-http --port 8000

Шаг 4. Перезапустите Claude Desktop или ваш MCP-клиент. Сервер появится в списке доступных инструментов.

Примеры запросов

  • «Проанализируй дамп из последнего падения. Почему произошёл Access Violation? Покажи стек вызовов.»
  • «Посмотри все файлы в C:\Dumps\AppX. Найди те, где есть повторяющиеся Heap Corruption.»
  • «Подключись к удалённому отладчику на 192.168.1.50:5000 и собери дамп текущего состояния потоков.»
  • «Объясни, что значит команда !analyze -v. Какая строка указывает на настоящую причину краша?»

Технические детали

  • Язык разработки: Python
  • Транспорт: stdio, streamable-http
  • Лицензия: MIT
  • Обязательное ПО: WinDbg/CDB (входят в Windows SDK)
  • Совместимые клиенты: Claude Desktop, VS Code, Cursor, GitHub Copilot, Windsurf, Cline

Поделиться