systemd-coredump MCP 服务器

一个用于与 systemd-coredump 功能交互的模型上下文协议 (MCP) 服务器。这使具有 MCP 功能的应用程序能够访问、管理和分析系统核心转储。

功能

• 列出系统中所有可用的核心转储
• 获取有关特定核心转储的详细信息
• 将核心转储文件提取到指定位置
• 从系统中删除核心转储

前提条件

• Node.js 18+ 和 npm
• 必须在系统上安装和配置 systemd-coredump
• 必须提供 coredumpctl 命令行实用程序

安装

从 npm 安装（推荐）

全局安装

npm install -g @taskjp/server-systemd-coredump

本地安装

npm install @taskjp/server-systemd-coredump

从源代码安装

1. 克隆存储库或下载源代码
2. 安装依赖项：

cd systemd-coredump-server
npm install

3. 构建服务器：

npm run build

配置

将服务器添加到您的 MCP 设置配置文件：

如果从 npm 全局安装：

"systemd-coredump": {
  "command": "systemd-coredump-server",
  "args": [],
  "disabled": false,
  "autoApprove": []
}

如果从 npm 本地安装：

"systemd-coredump": {
  "command": "node",
  "args": ["node_modules/@taskjp/server-systemd-coredump/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

如果从源代码安装：

"systemd-coredump": {
  "command": "node",
  "args": ["/path/to/systemd-coredump-server/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

用法

可用工具

服务器提供以下工具：

1. list_coredumps: 列出系统中所有可用的核心转储

   {
     "name": "list_coredumps"
   }
   

2. get_coredump_info: 获取有关特定核心转储的详细信息

   {
     "name": "get_coredump_info",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }
   

3. extract_coredump: 将核心转储提取到文件

   {
     "name": "extract_coredump",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345",
       "outputPath": "/path/to/output/core.dump"
     }
   }
   

4. remove_coredump: 从系统中删除核心转储

   {
     "name": "remove_coredump",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }
   

5. get_coredump_config: 获取系统当前的 core dump 配置

   {
     "name": "get_coredump_config"
   }
   

   此工具返回有关当前核心转储配置的信息，包括：

   • 是否启用核心转储
   • 当前的核心模式
   • 核心大小限制
   • systemd 是否正在处理核心转储

6. set_coredump_enabled: 启用或禁用核心转储生成

   {
     "name": "set_coredump_enabled",
     "arguments": {
       "enabled": true
     }
   }
   

   将 enabled 设置为 true 将启用核心转储，而 false 将禁用它们。 注意：这会更改当前 shell 的 ulimit 设置。 对于永久性的系统范围 更改，需要 root 权限和修改系统配置文件。

7. get_stacktrace: 使用 GDB 从核心转储获取堆栈跟踪

   {
     "name": "get_stacktrace",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }
   

   此工具使用 GDB 从核心转储中提取格式化的堆栈跟踪。 注意：需要系统上安装 GDB 调试器。

可用资源

服务器公开两种类型的资源：

1. 核心转储信息

   • URI 格式：coredump:///<id>
   • 返回带有详细核心转储信息的 JSON

2. 堆栈跟踪

   • URI 格式：stacktrace:///<id>
   • 从核心转储返回格式化的堆栈跟踪

其中 <id> 是核心转储的唯一标识符，格式为：<timestamp>-<pid>。

例如：

coredump:///2023-04-20 12:34:56-12345
stacktrace:///2023-04-20 12:34:56-12345

权限说明

某些操作可能需要提升的权限，尤其是在提取或删除核心转储时。 确保运行 MCP 服务器的用户具有访问系统核心转储的适当权限。

许可证

MIT