Crash MCP Server

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

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

功能特性

• 统一会话: 同时支持 crash 和 drgn 引擎
• 会话去重: 同一 vmcore 自动复用已有会话
• 命令持久化: 输出自动落盘，支持分页和搜索
• 远程分析: 通过 SSH 连接远程主机，无需下载 vmcore
• 多传输模式: Stdio（默认） / SSE（HTTP）
• 智能架构识别: 自动检测 vmcore 架构并选择对应的 crash 版本
• 自动编译: 内置 crash 工具编译器，支持多架构和压缩格式

安装

前置要求

• Python 3.10+
• crash 工具（可通过内置编译器安装）
• python3-dev (编译 PyKdump 需要)
• drgn 工具（通过 pip 自动安装）

快速安装

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

编译 Crash 工具

# 激活虚拟环境
source venv/bin/activate

# 查看依赖安装说明
compile-crash --deps

# 编译 x86_64 版本
compile-crash

# 编译 ARM64 版本（在 x86_64 上分析 ARM64 vmcore）
compile-crash --arch ARM64

# 编译带 PyKdump 支持的版本
compile-crash --pykdump-from-source

使用

启动服务器

# Stdio 模式
crash-mcp

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

MCP 工具

工具	说明
open_vmcore_session	打开 vmcore 崩溃转储文件进行分析
run_crash_command	执行 crash 命令，支持 PyKdump 扩展
run_drgn_command	执行 drgn Python 代码
close_vmcore_session	关闭当前分析会话
get_command_output	分页获取长命令输出
search_command_output	正则搜索命令输出
run_analysis_script	运行预定义分析脚本 (需配置 DRGN_SCRIPTS_PATH)
list_analysis_scripts	列出可用分析脚本 (需配置 DRGN_SCRIPTS_PATH)
get_crash_info	获取崩溃诊断报告 (需配置 GET_DUMPINFO_SCRIPT)

配置

环境变量	默认值	说明
CRASH_EXTENSION_LOAD	true	是否自动加载扩展
CRASH_MCP_TRUNCATE_LINES	20	输出截断行数
CRASH_MCP_WORKDIR	/tmp/crash-mcp-sessions	会话工作目录
CRASH_MCP_CACHE	true	启用命令缓存
LOG_LEVEL	INFO	日志级别
GET_DUMPINFO_SCRIPT	(空)	自动化诊断脚本命令模板 (如 python3 script.py {vmcore} {vmlinux})
DRGN_SCRIPTS_PATH	(空)	外部 drgn 脚本搜索路径 (冒号分隔)

客户端配置

Claude Desktop (claude_desktop_config.json):

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

示例

# 本地分析
open_vmcore_session("/var/crash/vmcore", "/usr/lib/debug/vmlinux")
run_crash_command("bt")
run_crash_command("sys")
run_drgn_command("prog['init_task'].comm")

# 分页获取长输出
run_crash_command("ps")  # 返回 command_id
get_command_output("crash:ps", offset=20, limit=50)

# 搜索输出
search_command_output("crash:bt", "schedule")

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

常见问题

1. no lzo compression support 错误

vmcore 文件使用 LZO 压缩，但 crash 工具编译时未启用 LZO 支持。

sudo apt-get install liblzo2-dev
compile-crash --clean

2. 缺少 GMP/MPFR 库

sudo apt-get install libgmp-dev libmpfr-dev

3. 查看所有编译依赖

compile-crash --deps

许可证

MIT License