systemd-coredump MCP サーバー

systemd-coredump 機能と連携するための Model Context Protocol (MCP) サーバー。これにより、MCP 対応アプリケーションはシステムコアダンプにアクセスし、管理および分析できるようになります。

特徴

• システムで利用可能なすべてのコアダンプを一覧表示します

• 特定のコアダンプに関する詳細情報を取得する

• コアダンプファイルを指定された場所に抽出する

• システムからコアダンプを削除する

Related MCP server: Dynamic MCP Server

前提条件

• 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 : システムの現在のコアダンプ設定を取得します。

   {
     "name": "get_coredump_config"
   }

   このツールは、次のような現在のコア ダンプ構成に関する情報を返します。

   • コアダンプが有効かどうか

   • 現在のコアパターン

   • コアサイズの制限

   • systemdがコアダンプを処理しているかどうか

6. set_coredump_enabled : コアダンプの生成を有効または無効にする

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

   enabledをtrueに設定するとコアダンプが有効になり、 falseに設定すると無効になります。注: これにより、現在のシェルの ulimit 設定が変更されます。システム全体に永続的な変更を加えるには、root 権限とシステム設定ファイルの変更が必要になります。

7. get_stacktrace : GDB を使用してコアダンプからスタック トレースを取得する

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

   このツールはGDBを使用して、コアダンプからフォーマットされたスタックトレースを抽出します。注: システムにGDBデバッガーがインストールされている必要があります。

利用可能なリソース

サーバーは次の 2 種類のリソースを公開します。

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サーバーを実行しているユーザーが、システムコアダンプにアクセスするための適切な権限を持っていることを確認してください。

ライセンス

マサチューセッツ工科大学