Rust Minidump MCP

An MCP (Model Context Protocol) server that empowers AI agents and developers to understand application crashes. By bridging powerful Rust-based crash analysis tools with AI capabilities, this project transforms cryptic crash dumps into clear, actionable insights - helping you quickly identify root causes and fix critical issues.

🚀 Features

• Minidump Analysis: Analyze Windows crash dump files (.dmp) to get detailed stack traces

• Symbol Extraction: Extract Breakpad symbols from binaries (PDB, DWARF formats)

• Multiple Transport Support: stdio (default), Streamable HTTP, and SSE transports

• AI-Powered Analysis: Built-in prompts for AI-assisted crash debugging

• Cross-Platform: Works on Windows, macOS, and Linux

• Comprehensive Error Handling: Detailed error messages with actionable suggestions

📋 Prerequisites

• Python 3.11 or higher

• uv package manager (optional, for development)

🚀 Quick Start

Method 1: Using uvx (Recommended)

Run directly without installation:

Method 2: Using pip

Install from PyPI:

Method 3: Using uv

Add to your project:

After installation, run:

📚 Usage

Running the Server

STDIO Transport (Default)

Streamable HTTP Transport

SSE Transport

Running the Client

The client is a simple testing tool for the MCP server - you typically won't need it unless you're developing or debugging the server.

📚 MCP Tools

stackwalk_minidump

Analyzes minidump crash files to produce human-readable stack traces.

Parameters:

• minidump_path (str, required): Path to the minidump file

• symbols_path (str, optional): Path to symbol files or directories

• output_format (str, optional): Output format - "json" or "text" (default: "json")

extract_symbols

Converts debug symbols from native formats (PDB, DWARF) to Breakpad format for use with stackwalk_minidump.

Parameters:

• binary_path (str, required): Path to the binary file with debug info

• output_dir (str, optional): Directory to save converted symbols (default: ./symbols/)

🎯 MCP Prompts

The server provides three specialized prompts for comprehensive crash analysis:

analyze_crash_with_expertise

Expert-level crash analysis with role-based insights:

• Detects programming language from modules/symbols

• Provides concrete code improvement suggestions

• Identifies crash patterns and prevention strategies

• Offers tailored advice based on the technology stack

analyze_technical_details

Deep technical analysis of crash internals:

• Register state interpretation

• Stack frame pattern analysis

• Memory corruption detection

• Symbol-less frame estimation techniques

symbol_transformation_guide

Comprehensive guide for symbol preparation:

• Explains Breakpad format requirements

• Documents dump_syms tool usage

• Shows expected directory structure

• Common troubleshooting tips

🤖 AI Agent Integration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code

Claude Code automatically detects MCP servers. After installation:

1. Open Claude Code in your project directory

2. The rust-minidump-mcp server will be available for crash analysis tasks

VS Code with Continue.dev

Add to your Continue configuration (~/.continue/config.json):

🔧 Configuration

Environment Variables

Copy .env.example to .env and customize:

Configuration Priority

1. CLI arguments (highest priority)

2. Environment variables

3. .env file

4. Default values (lowest priority)

📊 Understanding Crash Analysis

Minidump Files

Minidump files (.dmp) are compact crash reports generated when a Windows application crashes. They contain:

• Thread information and stack traces

• CPU register states

• Loaded module list

• Exception information

• System information

Symbol Files

Symbol files map memory addresses to human-readable function names and source locations:

• PDB files: Windows debug symbols

• DWARF: Linux/macOS debug information

• Breakpad format: Cross-platform symbol format (.sym)

Symbol Directory Structure

Breakpad symbols follow a specific directory structure:

🛠️ Installation Details

Prerequisites

• Python 3.11 or higher

• uv package manager

• just command runner (optional)

Install from Source

1. Clone the repository:

2. Install dependencies:

This will automatically create a virtual environment and install all dependencies.

3. Install Rust tools (Optional):

The project includes pre-compiled Rust binaries in minidumpmcp/tools/bin/. They are automatically used when running the tools.

If you need to update or reinstall them:

🐛 Troubleshooting

Common Issues

1. Binary not found error

   Solution: Run 'just install-tools' to install required binaries

2. Connection refused error

   Solution: Ensure the server is running on the correct port Check: rust-minidump-mcp server --transport streamable-http --port 8000

3. Invalid minidump format

   Solution: Ensure the file is a valid Windows minidump (.dmp) file

🏗️ Architecture

Project Structure

Transport Support

• stdio: Standard input/output for CLI integration

• streamable-http: Streamable HTTP transport for web services

• sse: Server-Sent Events for real-time streaming

🧪 Development

Running Tests

Code Quality

Available Commands

See all available commands:

Common commands:

• just install-tools: Install Rust binaries

• just test: Run tests

• just lint: Run linters

• just format: Format code

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/AmazingFeature)

3. Commit your changes (git commit -m 'Add some AmazingFeature')

4. Push to the branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Projects

• rust-minidump: The Rust library powering our analysis tools

• FastMCP: The MCP framework used for server/client implementation

• Breakpad: The crash reporting system that defines the symbol format