关键词

调试器内存转储崩溃分析符号管理

项目简介

Debugger MCP Server是一个基于Model Context Protocol构建的跨平台调试服务器，能够控制WinDbg和LLDB调试器，分析Windows和Linux/macOS的内存转储文件。

主要功能

  • 跨平台支持：Windows使用WinDbg和DbgEng COM API，Linux/macOS使用LLDB进程通信
  • 混合架构：支持stdio模式（本地调试）和HTTP/SSE模式（远程服务器）
  • 自动化分析：支持崩溃分析、.NET分析、性能分析、安全漏洞检测
  • 多租户支持：最多50个并发会话，每个用户最多5个会话
  • 符号管理：自动配置Microsoft符号服务器，支持批量上传和ZIP归档
  • 转储比较：支持两个内存转储的对比分析
  • 报告生成：支持Markdown、HTML、JSON格式
  • 源链接集成：从Portable PDBs提取源链接信息
  • 会话管理：支持创建、列表、恢复和关闭调试会话

安装步骤

  1. 安装.NET 10：从官网下载安装
  2. 安装平台特定调试器：
    • Windows：安装Windows SDK（包含调试工具）
    • Linux/macOS：安装LLDB和SOS插件
  3. 克隆和构建： 
    git clone https://github.com/tonyredondo/debugger-mcp-server.git
cd debugger-mcp-server
dotnet build -c Release
  4. 运行服务器：
    • MCP模式（stdio）：'dotnet run'
    • HTTP API模式：'dotnet run -- --http'
    • 统一模式（MCP + 上传API）：'dotnet run -- --mcp-http

配置信息（JSON格式）

{
  "mcpServers": {
    "debugger-local": {
      "command": "C:\\path\\to\\DebuggerMcp.exe",
      "args": []
    }
  }
  • 本地模式（stdio）：适用于Claude Desktop、Cline等本地MCP客户端
  • **远程/Docker模式（HTTP/SSE）：
{
  "mcpServers": {
    "debugger-remote": {
      "transport": {
        "type": "http",
        "url": "http://localhost:5000/mcp"
    }
  }

基本使用方法

  1. 上传转储文件：通过HTTP API上传.dmp或.core文件
  2. 上传符号文件（可选）：支持单个、批量或ZIP格式
  3. 使用MCP工具分析：
    • 创建会话：'session(action="create", userId="user123")'
    • 打开转储：'dump(action="open", sessionId, userId, dumpId="abc123")'
    • 执行命令：'exec(sessionId, userId, command="!threads")'
    • 分析崩溃：'analyze(kind="crash", sessionId, userId)'
    • 生成报告：'report(action="full", sessionId, userId, format="html")'
  4. 关闭会话：'session(action="close", sessionId, userId)'

信息

分类

开发者工具

访问项目