/ 目录 / 演练场 / 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 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

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

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "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 使用服务器对象数组,而非映射。

~/.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 搭配,撬动十倍杠杆

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
每次调用 Token 数
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

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills