/ 디렉터리 / 플레이그라운드 / 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와 조합해 10배 효율

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

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기