/ Каталог / Песочница / mcp-windbg
● Сообщество svnscha ⚡ Сразу

mcp-windbg

автор svnscha · svnscha/mcp-windbg

AI-assisted Windows debugging — analyze crash dumps, live debug remote targets, and run WinDbg commands via natural language.

mcp-windbg is an MCP server that bridges AI models with WinDbg/CDB for Windows crash dump analysis and live debugging. It provides 7 tools for listing/opening/closing dumps, connecting to remote debug targets, executing WinDbg commands, and sending break signals. Supports batch processing of multiple dumps and multiple transport protocols (stdio, HTTP).

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

mcp-windbg.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-windbg": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/svnscha/mcp-windbg"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-windbg": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/svnscha/mcp-windbg"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-windbg": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/svnscha/mcp-windbg"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-windbg": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/svnscha/mcp-windbg"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-windbg",
      "command": "TODO",
      "args": [
        "See README: https://github.com/svnscha/mcp-windbg"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-windbg": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/svnscha/mcp-windbg"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcp-windbg -- TODO 'See README: https://github.com/svnscha/mcp-windbg'

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: mcp-windbg

How to analyze a Windows crash dump with AI assistance

👤 Windows developers investigating application crashes ⏱ ~30 min intermediate

Когда использовать: You have a .dmp file from a crash and need to understand what happened.

Предварительные требования
  • Windows with Debugging Tools/WinDbg — Install from Microsoft Store or Windows SDK
  • mcp-windbg installed — pip install mcp-windbg
Поток
  1. Open the dump
    Open the crash dump at C:\dumps\app_crash.dmp. Run !analyze -v and explain what caused the crash.✓ Скопировано
    → Detailed crash analysis with exception type, faulting module, and call stack
  2. Investigate the call stack
    Show me the full call stack of the faulting thread. What was the application doing when it crashed?✓ Скопировано
    → Annotated call stack with function descriptions
  3. Check for patterns
    Run !locks and !heap -s. Is there a deadlock or heap corruption?✓ Скопировано
    → Lock/heap analysis results with interpretation

Итог: Root cause of the crash identified with a clear explanation.

Подводные камни
  • Missing symbol files — Set up a symbol path: .sympath SRV*c:\symbols*https://msdl.microsoft.com/download/symbols
Сочетать с: filesystem

Batch analyze multiple crash dumps to find patterns

👤 Support engineers investigating recurring crashes ⏱ ~45 min intermediate

Когда использовать: You have multiple crash dumps from the same application and need to find common patterns.

Предварительные требования
  • mcp-windbg and WinDbg installed — pip install mcp-windbg
Поток
  1. List available dumps
    List all crash dump files in C:\dumps\. How many are there and when were they created?✓ Скопировано
    → List of dumps with timestamps
  2. Analyze and compare
    Open each dump, run !analyze -v, and give me a summary comparing the crash reasons. Are they the same bug or different issues?✓ Скопировано
    → Comparison table showing crash type, module, and stack similarity

Итог: Pattern analysis across multiple crashes to prioritize fixes.

Подводные камни
  • Large dumps take time to analyze — Start with minidumps if available — they're faster to open
Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

mcp-windbg + filesystem

Export crash analysis reports to files for bug tracking

Analyze all dumps in C:\dumps\ and write a summary report to C:\reports\crash-analysis.md.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
list_windbg_dumps directory: str Discover crash dump files in a directory 0
open_windbg_dump dump_path: str Open and analyze a crash dump 0
close_windbg_dump session_id: str Close a dump analysis session 0
open_windbg_remote connection_string: str Connect to a remote debug target 0
run_windbg_cmd session_id: str, command: str Execute any WinDbg command in a session 0
send_ctrl_break session_id: str Break into a running debug target 0

Стоимость и лимиты

Во что обходится

Квота API
N/A — fully local
Токенов на вызов
300–3000 tokens per command output
Деньги
Free — WinDbg is free from Microsoft
Совет
Use targeted WinDbg commands (!analyze -v, k) instead of verbose outputs to reduce tokens.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: N/A for local dumps. Remote debugging may require authentication.
Исходящий трафик: Local analysis only. Symbol downloads go to Microsoft's symbol server.

Устранение неполадок

Частые ошибки и исправления

WinDbg/CDB not found

Install Debugging Tools for Windows from the Windows SDK or WinDbg from Microsoft Store.

Проверить: where cdb
Symbols not loading

Configure symbol path: run_windbg_cmd with '.sympath SRV*c:\symbols*https://msdl.microsoft.com/download/symbols' then '.reload'

Проверить: Run 'lm' to check loaded modules
Dump file corrupted or incomplete

The dump may be a minidump missing key data. Request a full dump from the application or use procdump to capture a new one.

Проверить: Check dump file size — minidumps are typically <100MB

Альтернативы

mcp-windbg в сравнении

АльтернативаКогда использоватьКомпромисс
cheatengine-mcp-bridgeYou need live memory analysis of running processes rather than crash dump analysisLive process manipulation vs post-mortem analysis

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills