MCP Sumo Logic

MCP Sumo Logic

Sumo Logic の API と統合し、ログ検索を実行する Model Context Protocol（MCP）サーバーです。

特徴

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

環境変数

ENDPOINT=https://{host}/api/v1  # Sumo Logic API endpoint
SUMO_API_ID=your_api_id                       # Sumo Logic API ID
SUMO_API_KEY=your_api_key                     # Sumo Logic API Key

セットアップ

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={index} | 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

Makefile

make から一般的なタスクを実行できます：

コマンド	説明
make install	依存関係をインストールします
make build	プロジェクトをビルドします
make start	サーバーを起動します
make dev	開発モードで起動します（自動リロード）
make clean	dist/ と node_modules/ を削除します
make lint	ESLint を実行します
make test	テストを実行します
make docker-build	Docker イメージをビルドします
make docker-run	.env ファイルを使用してポート 3006 でコンテナを実行します
make docker-compose	Docker Compose でサービスを起動します
make docker-down	Docker Compose のサービスを停止します