systemd-coredump MCP サーバー
systemd-coredump 機能と連携するための Model Context Protocol (MCP) サーバー。これにより、MCP 対応アプリケーションはシステムコアダンプにアクセスし、管理および分析できるようになります。
特徴
- システムで利用可能なすべてのコアダンプを一覧表示します
- 特定のコアダンプに関する詳細情報を取得する
- コアダンプファイルを指定された場所に抽出する
- システムからコアダンプを削除する
前提条件
- Node.js 18+ および npm
- systemd-coredumpがシステムにインストールされ設定されている必要があります
coredumpctlコマンドラインユーティリティが利用可能である必要があります
インストール
npmから（推奨）
グローバルインストール
npm install -g @taskjp/server-systemd-coredump
ローカルインストール
npm install @taskjp/server-systemd-coredump
ソースから
- リポジトリをクローンするか、ソースコードをダウンロードする
- 依存関係をインストールします:
cd systemd-coredump-server
npm install
- サーバーを構築します。
構成
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": []
}
使用法
利用可能なツール
サーバーは次のツールを提供します。
- list_coredumps : システムで利用可能なすべてのコアダンプを一覧表示します
{
"name": "list_coredumps"
}
- get_coredump_info : 特定のコアダンプの詳細情報を取得する
{
"name": "get_coredump_info",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
- extract_coredump : コアダンプをファイルに抽出する
{
"name": "extract_coredump",
"arguments": {
"id": "2023-04-20 12:34:56-12345",
"outputPath": "/path/to/output/core.dump"
}
}
- Remove_coredump : システムからコアダンプを削除する
{
"name": "remove_coredump",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
- get_coredump_config : システムの現在のコアダンプ設定を取得します。
{
"name": "get_coredump_config"
}
- コアダンプが有効かどうか
- 現在のコアパターン
- コアサイズの制限
- systemdがコアダンプを処理しているかどうか
- set_coredump_enabled : コアダンプの生成を有効または無効にする
{
"name": "set_coredump_enabled",
"arguments": {
"enabled": true
}
}
enabledをtrueに設定するとコアダンプが有効になり、 falseに設定すると無効になります。注: これにより、現在のシェルの ulimit 設定が変更されます。システム全体に永続的な変更を加えるには、root 権限とシステム設定ファイルの変更が必要になります。 - get_stacktrace : GDB を使用してコアダンプからスタック トレースを取得する
{
"name": "get_stacktrace",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
利用可能なリソース
サーバーは次の 2 種類のリソースを公開します。
- コアダンプ情報
- URI 形式:
coredump:///<id> - 詳細なコアダンプ情報を含むJSONを返します
- スタックトレース
- URI 形式:
stacktrace:///<id> - コアダンプからフォーマットされたスタックトレースを返します
ここで、 <id>は、 <timestamp>-<pid>という形式のコアダンプの一意の識別子です。
例えば：
coredump:///2023-04-20 12:34:56-12345
stacktrace:///2023-04-20 12:34:56-12345
権限に関する注意
一部の操作、特にコアダンプの抽出や削除には、昇格した権限が必要になる場合があります。MCPサーバーを実行しているユーザーが、システムコアダンプにアクセスするための適切な権限を持っていることを確認してください。
ライセンス
マサチューセッツ工科大学