windbg-cli

windbg-cli

WinDbg/CDB crash dump analysis CLI tools with SKILLS for coding agents.

Forked from svnscha/mcp-windbg — the original MCP server for WinDbg crash analysis.

Available Skills

Skill	Description
windbg-cli	Analyze Windows crash dumps and debug processes using WinDbg/CDB

What are Skills?

Skills are lightweight prompts that teach coding agents how to use CLI tools effectively. They provide:

• Token-efficient workflows that don't bloat LLM context
• Purpose-built commands for specific tasks
• Best practices for common scenarios

Requirements

• Windows with Debugging Tools for Windows or WinDbg from Microsoft Store
• Python 3.10+
• uv package manager (recommended)

Installing the Skill

GitHub Copilot CLI (recommended)

/plugin marketplace add davidfowl/mcp-windbg
/plugin install windbg-cli@mcp-windbg

Claude Code

mkdir -p .claude/skills/windbg-cli
curl -o .claude/skills/windbg-cli/SKILL.md \
  https://raw.githubusercontent.com/davidfowl/mcp-windbg/main/skills/windbg-cli/SKILL.md

Quick Start

# List available crash dumps
uv run --from windbg-cli windbg list-dumps

# Analyze a dump with full details
uv run --from windbg-cli windbg analyze C:\path\to\crash.dmp --all

# Run a single WinDbg command
uv run --from windbg-cli windbg cmd --dump C:\path\to\crash.dmp -c "!analyze -v"

# Interactive WinDbg shell
uv run --from windbg-cli windbg shell --dump C:\path\to\crash.dmp

CLI Commands

Command	Purpose
list-dumps	Discover crash dump files in a directory
analyze	One-shot crash dump analysis with optional --stack, --modules, --threads, --all
cmd	Run a single WinDbg command against a --dump or --remote target
shell	Interactive WinDbg REPL for a --dump or --remote target

Global Options

--cdb-path PATH        Custom path to cdb.exe
--symbols-path PATH    Custom symbols path
--timeout SECONDS      Command timeout (default: 30)
--verbose              Enable verbose CDB output

Skills-less Operation

You can also point your agent directly at the tool's help:

Analyze C:\dumps\app.dmp using windbg.
Check uv run --from windbg-cli windbg --help for available commands.

License

MIT