Crash MCP Server

这是一个基于 MCP (Model Context Protocol) 的服务器，专门用于辅助 系统崩溃转储 (Crash Dump) 的分析。

它封装了 Linux 的 crash 实用程序，允许 AI 助手通过 MCP 协议自动发现转储文件、匹配内核、并执行交互式崩溃分析命令。

功能特性 (Features)

1. 自动发现转储文件:

   • 能够扫描指定目录（默认 /var/crash）下的 vmcore、core 等转储文件。

2. 智能内核匹配:

   • 尝试自动寻找与转储文件匹配的 vmlinux 内核文件（支持同目录查找）。

3. 交互式 Crash 会话:

   • 通过 pexpect 管理 crash 工具的交互式会话。

   • 支持长时间运行的会话，保持上下文。

4. MCP 工具集:

   • list_crash_dumps: 列出可用的转储文件。

   • start_crash_session:启动一个新的分析会话。

   • run_crash_command: 在当前会话中执行任意 crash 命令 (如 sys, bt, ps 等)。

   • get_sys_info: 获取系统基本信息的快捷工具。

5. 配置灵活:

   • 支持通过 .env 文件配置浏览器（预留）和分析路径。

安装与使用 (Installation & Usage)

前置要求

• 系统需安装 Python 3.10+

• 系统需安装 crash 工具 (用于实际分析)

• 系统需安装 pip (Python 包管理器)

安装与使用 (Installation & Usage)

前置要求

• 系统需安装 Python 3.10+

• 系统需安装 crash 工具 (用于实际分析)

• 建议使用 Linux 环境 (Debian/Ubuntu)

1. 快速安装 (推荐)

我们提供了一个脚本来自动创建虚拟环境 (venv) 并安装依赖：

注意: 如果脚本提示缺少 python3-venv，请按提示安装：sudo apt install python3-venv

2. 手动安装 (Manual Install)

如果你更喜欢手动操作：

3. 配置

你可以复制示例配置文件并进行修改：

主要配置项：

• CRASH_SEARCH_PATH: 崩溃转储文件的搜索路径（默认 /var/crash）。

4. 运行服务器

命令行运行:

在 Claude Desktop 中配置: 在 mcpServers 配置中，直接指定虚拟环境中的 python 解释器路径：

开发与测试

运行单元测试：

项目包含一个 mock_crash.py 脚本，用于在没有真实 crash 工具的环境下测试交互逻辑。