MCP Sumologic

🚀 MCP Sumo Logic

Sumo Logic APIを統合したログ検索サーバーで、ログ検索操作を実行するために使用されます。

✨ 主な機能

• カスタムクエリを使用してSumo Logicのログを検索することができます。
• 検索時の時間範囲を設定可能です。
• 完全なエラー処理と詳細なログ記録が行われます。
• Dockerをサポートしており、簡単にデプロイできます。

📦 インストール

環境変数

ENDPOINT=https://api.au.sumologic.com/api/v1  # Sumo Logic APIエンドポイント
SUMO_API_ID=your_api_id                       # Sumo Logic API ID
SUMO_API_KEY=your_api_key                     # Sumo Logic APIキー

手順

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. 必要な環境変数を含む.envファイルを作成します。
4. プロジェクトをビルドします。

   npm run build
   

5. サーバーを起動します。

   npm start
   

Docker 構成

1. Dockerイメージをビルドします。

   docker build -t mcp/sumologic .
   

2. コンテナを実行します（方法を選択）。

   a. 直接環境変数を使用する場合：

   docker run -e ENDPOINT=your_endpoint -e SUMO_API_ID=your_api_id -e SUMO_API_KEY=your_api_key mcp/sumologic
   

   b. .envファイルを使用する場合：

   docker run --env-file .env mcp/sumologic
   

   注意：.envファイルに必要な環境変数が含まれていることを確認してください。

   ENDPOINT=your_endpoint
   SUMO_API_ID=your_api_id
   SUMO_API_KEY=your_api_key
   

💻 使用例

基本的な使用法

サーバーはsearch-sumologicツールを提供しており、以下のパラメータを受け付けます。

• query（必須）：Sumo Logic検索クエリ
• from（オプション）：開始時間（ISO 8601形式）
• to（オプション）：終了時間（ISO 8601形式）

クエリの例：

const query = '_index=app_pro_fiat_cont | json auto | fields log_identifier';
const results = await search(sumoClient, query, {
  from: '2024-02-23T00:00:00Z',
  to: '2024-02-24T00:00:00Z',
});

🔧 技術詳細

エラー処理

サーバーには完全なエラー処理とログ記録が含まれています。

• APIエラーの詳細をキャッチして記録します。
• 検索ジョブの状態を監視して記録します。
• ネットワークと認証の問題を適切に処理します。

開発

開発モードで実行するには：

npm run dev

テストを実行するには：

npm test