# 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 自动安装）
### 快速安装
```bash
chmod +x install.sh && ./install.sh
```
### 编译 Crash 工具
```bash
# 激活虚拟环境
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
```
## 使用
### 启动服务器
```bash
# 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`):
```json
{
"mcpServers": {
"crash-analysis": {
"command": "/path/to/crash-mcp/venv/bin/crash-mcp"
}
}
}
```
## 示例
```python
# 本地分析
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 支持。
```bash
sudo apt-get install liblzo2-dev
compile-crash --clean
```
### 2. 缺少 GMP/MPFR 库
```bash
sudo apt-get install libgmp-dev libmpfr-dev
```
### 3. 查看所有编译依赖
```bash
compile-crash --deps
```
## 许可证
[MIT License](LICENSE)
