# Crash MCP Server
基于 MCP (Model Context Protocol) 的服务器，用于 **系统崩溃转储 (Crash Dump)** 分析。
集成 Linux `crash` 实用程序和 `drgn` 可编程调试器，提供统一分析接口。
## 功能特性
- **统一会话**: 同时支持 `crash` 和 `drgn` 引擎
- **远程分析**: 通过 SSH 连接远程主机，无需下载 vmcore
- **多传输模式**: Stdio（默认） / SSE（HTTP）
- **自动发现**: 扫描指定目录下的转储文件
## 安装
### 前置要求
- Python 3.10+
- `crash` 工具
- `drgn` 工具（可选）
### 快速安装
```bash
chmod +x install.sh && ./install.sh
```
## 使用
### 启动服务器
```bash
# 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` | 获取系统信息 |
### 配置
```bash
cp .env.example .env
```
- `CRASH_SEARCH_PATH`: 搜索转储文件的路径（默认 `/var/crash`）
- `LOG_LEVEL`: 日志级别
### 客户端配置
**Claude Desktop** (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"crash-analysis": {
"command": "/path/to/crash-mcp/venv/bin/crash-mcp"
}
}
}
```
**SSE 连接**: `http://localhost:8000/sse`
## 示例
```python
# 本地分析
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](LICENSE)
