Crash MCP Server

Name: crash-mcp
Availability: InStock

基于 MCP (Model Context Protocol) 的服务器，用于 系统崩溃转储 (Crash Dump) 分析。

集成 Linux crash 实用程序和 drgn 可编程调试器，提供统一分析接口。

功能特性

统一会话: 同时支持 crash 和 drgn 引擎
远程分析: 通过 SSH 连接远程主机，无需下载 vmcore
多传输模式: Stdio（默认） / SSE（HTTP）
自动发现: 扫描指定目录下的转储文件

安装

前置要求

Python 3.10+
crash 工具
drgn 工具（可选）

快速安装

chmod +x install.sh && ./install.sh

使用

启动服务器

# Stdio 模式
crash-mcp

# SSE 模式
crash-mcp --transport sse --port 8000

MCP 工具

工具	说明
`list_crash_dumps`	扫描目录查找 vmcore 文件
`start_session`	启动分析会话（需要 vmcore 和 vmlinux 路径）
`run_crash_command`	执行 crash 命令（如 sys, bt, log, ps）
`run_drgn_command`	执行 drgn Python 代码（如 prog.crashed_thread()）
`stop_session`	关闭会话
`get_sys_info`	获取系统信息

配置

cp .env.example .env

CRASH_SEARCH_PATH: 搜索转储文件的路径（默认 /var/crash）
LOG_LEVEL: 日志级别

客户端配置

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "crash-analysis": {
      "command": "/path/to/crash-mcp/venv/bin/crash-mcp"
    }
  }
}

SSE 连接: http://localhost:8000/sse

示例

# 本地分析
start_session("/var/crash/vmcore", "/usr/lib/debug/vmlinux")
run_crash_command("bt")
run_drgn_command("prog.crashed_thread()")

# 远程分析
start_session("/var/crash/vmcore", "/usr/lib/debug/vmlinux", 
              ssh_host="server-01", ssh_user="root")

许可证

MIT License

crash-mcp