MCP Systemd Coredump

🚀 systemd-coredump MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して systemd-coredump とのやり取りを可能にするツールです。MCP をサポートするアプリケーションは、このツールを使ってコアダンプファイルを管理できます。

ラベル

• npm バージョン:
• ライセンス: MIT

🚀 クイックスタート

このサーバーを使用することで、コアダンプファイルの一覧表示、詳細情報の取得、ファイルの抽出、削除などの操作が可能になります。以下の手順に従ってセットアップしてください。

✨ 主な機能

• すべての利用可能なコアダンプを一覧表示します。
• 特定のコアダンプの詳細情報を取得します。
• コアダンプファイルを抽出します。
• コアダンプを削除します。

📦 インストール

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 ライセンスの下で公開されています。