MCP Systemd Coredump

🚀 systemd-coredump MCP 服務器

這是一個 Model Context Protocol (MCP) 服務器，用於與 systemd-coredump 交互。該工具允許支持 MCP 的應用程序管理核心轉儲文件。

🚀 快速開始

這是一個用於與 systemd-coredump 交互的 Model Context Protocol (MCP) 服務器，支持 MCP 的應用程序可藉助它管理核心轉儲文件。

✨ 主要特性

該服務器提供以下功能：

1. 列出所有可用的核心轉儲。
2. 獲取特定核心轉儲的詳細信息。
3. 提取核心轉儲文件。
4. 移除核心轉儲。

📦 安裝指南

先決條件

要使用此服務器，您需要滿足以下要求：

• 安裝 Node.js（推薦版本：14.x 或更高）。
• 安裝 systemd-coredump 並確保其正常運行。
• 確保系統上存在 coredumpctl 命令。

安裝方式

從 npm 安裝

您可以使用以下命令全局安裝或本地安裝該服務器：

• 全局安裝：

npm install -g systemd-coredump

• 本地安裝：

npm install systemd-coredump

從源碼安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/systemd-coredump.git
cd systemd-coredump

2. 安裝依賴項：

npm install

📚 詳細文檔

配置

要在 MCP 設置文件中添加此服務器，請參考以下配置：

示例（全局安裝）

{
  "systemd-coredump": {
    "installed": true,
    "path": "/usr/local/bin/coredumpctl"
  }
}

示例（本地安裝）

{
  "systemd-coredump": {
    "installed": true,
    "path": "./node_modules/.bin/coredumpctl"
  }
}

使用方法

工具說明

以下是服務器提供的工具及其功能：

1. list_coredumps
   • 列出所有可用的核心轉儲。
   • 示例命令：

mcp list_coredumps

2. get_coredump_info
   • 獲取特定核心轉儲的詳細信息。
   • 示例命令：

mcp get_coredump_info --id <timestamp>-<pid>

3. extract_coredump
   • 提取核心轉儲文件到指定路徑。
   • 示例命令：

mcp extract_coredump --id <timestamp>-<pid> --output ./output/coredump.<timestamp>.dmp

4. remove_coredump
   • 移除特定的核心轉儲。
   • 示例命令：

mcp remove_coredump --id <timestamp>-<pid>

資源說明

服務器暴露以下資源：

1. 核心轉儲信息

   • URI 格式：coredump:///<id>
   • 返回 JSON 格式的詳細核心轉儲信息。

2. 堆棧跟蹤

   • URI 格式：stacktrace:///<id>
   • 返回格式化的堆棧跟蹤信息。

示例 URI：

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

注意事項

⚠️ 重要提示

某些操作（如提取或移除核心轉儲）可能需要管理員權限。請確保運行 MCP 服務器的用戶具有適當的權限。

📄 許可證

本項目採用 MIT 許可證。

標籤

• npm 版本:
• 許可證: MIT