Skip to main content
Glama
yup-21
by yup-21

Crash MCP Server

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

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

功能特性

  • 统一会话: 同时支持 crashdrgn 引擎

  • 会话去重: 同一 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

启动分析会话,返回 session_id 和 workdir

run_crash_command

执行 crash 命令,支持扩展命令如 crashinfo

run_drgn_command

执行 drgn Python 代码

stop_session

关闭会话

get_command_output

获取截断输出的剩余行

search_command_output

在命令输出中正则搜索

配置

环境变量

默认值

说明

CRASH_EXTENSION_LOAD

true

是否自动加载扩展

CRASH_MCP_TRUNCATE_LINES

20

输出截断行数

CRASH_MCP_WORKDIR

/tmp/crash-mcp-sessions

会话工作目录

CRASH_MCP_CACHE

true

启用命令缓存

LOG_LEVEL

INFO

日志级别

客户端配置

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yup-21/crash-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server