English | 简体中文

Dump Analyzer MCP Server

An MCP server for remote Windows Crash Dump analysis. It supports uploading dumps, creating analysis sessions, and executing CDB commands, returning structured status and raw output.

This enables AI agents to perform dump analysis via standard MCP interfaces by invoking CDB deployed on a Windows server, eliminating the need for the AI agent itself to run on a Windows operating system.

<!-- mcp-name: io.github.zuohuiyang/dump-analyzer-mcp-server -->

Core Capabilities

• Wraps the CDB debugger into standard remote MCP calling interfaces
• Provides a complete analysis closed-loop workflow: uploading dumps, creating sessions, executing commands, and closing sessions

Prerequisites

• OS: Windows
• Python: 3.10+
• Debugger: Windows SDK 26100+ (includes WinDbg/CDB)
• Clients must be able to access the --public-base-url

Security Boundaries

• Designed for intranet/trusted environments by default. No built-in authentication. Do not expose directly to the public internet.
• Cross-network access requires authentication, TLS, and access control provided by a frontend gateway.
• Dangerous commands (.shell, redirection, .create/.attach/.kill, etc.) are rejected by default.

Runtime Parameters

| Parameter | Default | Description | | -- | -- | -- | | --host | 0.0.0.0 | Service listen address | | --port | 8000 | Service listen port | | --public-base-url | Required | Externally accessible base URL, used to construct and return the dump upload URL to clients | | --cdb-path | Auto-detect | Path to cdb.exe | | --symbols-path | srv*c:\symbols*https://msdl.microsoft.com/download/symbols | Server-side symbol path | | --timeout | 1800 | Command execution timeout (seconds) | | --upload-dir | System temp dir | Temporary directory for uploads | | --max-upload-mb | 100 | Maximum dump file upload size (MB) | | --session-ttl-seconds | 1800 | Idle session TTL | | --max-active-sessions | 10 | Maximum active sessions | | --verbose | false | Enable DEBUG log level |

Quick Start

Installation via PyPI (Recommended)

pip install dump-analyzer-mcp-server
dump-analyzer-mcp-server --public-base-url http://<your-public-ip-or-domain>:8000

Run via uv (Development)

uv sync
uv run dump-analyzer-mcp-server --public-base-url http://<your-public-ip-or-domain>:8000

• MCP Endpoint: http://your-host:8000/mcp

MCP Client Configuration

{
  "mcpServers": {
    "dump-analyzer": {
      "url": "http://<your-public-ip-or-domain>:8000/mcp"
    }
  }
}

Documentation

• Development, Testing, E2E, CI: docs/development.md
• Technical Design & Protocol: docs/technical-design.md
• Development Log: docs/devlog.md

Acknowledgements

This project evolved from the upstream svnscha/mcp-windbg and has been focused as a dedicated MCP server for remote Windows Crash Dump analysis.

License

MIT