mcp-windbg

@svnscha/mcp-windbg

0 Stars 35 次浏览 svnscha 更新于 2026-08-23

A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-windbg": {
      "args": [
        "mcp-windbg@0.12.2"
      ],
      "command": "uvx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

MCP Server for WinDbg Crash Analysis

A Model Context Protocol server that bridges AI models with WinDbg for crash dump analysis and remote debugging.

<!- - mcp-name: io.github.svnscha/mcp-windbg - ->

# Overview

This MCP server integrates with CDB to enable AI models to analyze Windows crash dumps and connect to remote debugging sessions using WinDbg/CDB.

# What is this?

An AI-powered tool that bridges LLMs with WinDbg for crash dump analysis and live debugging. Execute debugger commands through natural language queries like "Show me the call stack and explain this access violation".

# What This is Not

Not a magical auto-fix solution. It's a Python wrapper around CDB that leverages LLM knowledge to assist with debugging.

# Usage Modes

Crash Dump Analysis: Examine Windows crash dumps
Live Debugging: Connect to remote debugging targets
Directory Analysis: Process multiple dumps for patterns

# Quick Start

# # Prerequisites

Windows with Debugging Tools for Windows or WinDbg from Microsoft Store.
Python 3.10 or higher
Any MCP-compatible client (GitHub Copilot, Claude Desktop, Cline, Cursor, Windsurf etc.)
Configure MCP server in your chosen client

[!TIP]
In enterprise environments, MCP server usage might be restricted by organizational policies. Check with your IT team about AI tool usage and ensure you have the necessary permissions before proceeding.

# # Installation

pip install mcp-windbg

# Transport Options

The MCP server supports multiple transport protocols:

# # Starting with Different Transports

Standard I/O (default):

mcp-windbg
#  or explicitly
mcp-windbg - -transport stdio

Streamable HTTP:

mcp-windbg - -transport streamable-http - -host 127.0.0.1 - -port 8000

Endpoint: http://127.0.0.1:8000/mcp

# # Command Line Options

- -transport {stdio,streamable-http}  Transport protocol (default: stdio)
- -host HOST                              HTTP server host (default: 127.0.0.1)
- -port PORT                              HTTP server port (default: 8000)
- -cdb-path PATH                          Custom path to cdb.exe
- -symbols-path PATH                      Custom symbols path
- -timeout SECONDS                        Command timeout (default: 30)
- -verbose                                Enable verbose output

# Configuration for Visual Studio Code

To make MCP servers available in all your workspaces, use the global user configuration:

Press F1, type > and select MCP: Open User Configuration.
Paste the following JSON snippet into your user configuration:

{
    "servers": {
        "mcp_windbg": {
            "type": "stdio",
            "command": "python",
            "args": ["-m", "mcp_windbg"],
            "env": {
                "_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
            }
        }
    }
}

This enables MCP Windbg in any workspace, without needing a local .vscode/mcp.json file.

# # HTTP Transport Configuration

For scenarios where you need to run the MCP server separately (e.g., remote access, shared server, or debugging the server itself), you can use the HTTP transport:

1. Start the server manually:

python -m mcp_windbg - -transport streamable-http - -host 127.0.0.1 - -port 8000

2. Configure VS Code to connect via HTTP:

{
    "servers": {
        "mcp_windbg_http": {
            "type": "http",
            "url": "http://localhost:8000/mcp"
        }
    }
}

Workspace-specific and alternative configuration: See Installation documentation for details on configuring Claude Desktop, Cline, and other clients, or for workspace-only setup.

Once configured, restart your MCP client and start debugging:

Analyze the crash dump at C:\dumps\app.dmp

# MCP Compatibility

This server implements the Model Context Protocol (MCP), making it compatible with any MCP-enabled client:

The beauty of MCP is that you write the server once, and it works everywhere. Choose your favorite AI assistant!

# # Tools

# Documentation

Documentation

# Examples

# # Crash Dump Analysis

Analyze this heap address with !heap -p -a 0xABCD1234 and check for buffer overflow"

Execute !peb and tell me if there are any environment variables that might affect this crash"

Run .ecxr followed by k and explain the exception's root cause"

# # Remote Debugging

"Connect to tcp:Port=5005,Server=192.168.0.100 and show me the current thread state"

"Check for timing issues in the thread pool with !runaway and !threads"

"Show me all threads with ~*k and identify which one is causing the hang"

# Blog

Read about the development journey: The Future of Crash Analysis: AI Meets WinDbg

# # Links

# Star History

[](https://www.star-history.com/# svnscha/mcp-windbg&Date)

# License

MIT

查看源码项目主页