logicmonitor-mcp

LogicMonitor MCPサーバー — LogicMonitor REST API (v3, /santaba/rest) を MCP ツールとして公開します。

概要

このサーバーは Model Context Protocol (Streamable HTTP/SSE トランスポート) を実装し、MSPbots 自身の LogicMonitor 統合で使用される LogicMonitor エンドポイントをラップします。MSPbots の Vendor MCP Service SOP に従います: ステートレス、資格情報の保存なし、リクエストごとのヘッダー認証。

基盤となる API は LMv1 で認証します — Access Id / Access Key のペアから計算されるリクエストごとの HMAC-SHA256 署名です(MSPbots 自身がこの統合で使用するのと同じスキーム: Company + Access Id + Access Key、OAuth なし)。このサーバーは、リクエストのヘッダーで提供された資格情報から、すべての送信リクエストに対して LMv1 署名を自身で計算します。資格情報を永続化することはありません。

Related MCP server: databricks-mcp

クイックスタート

Docker (推奨)

docker compose up --build

サーバーは http://localhost:8080 で起動します。

ローカル (uv)

uv sync
python -m logicmonitor_mcp

ヘルスチェック

curl http://localhost:8080/health
# {"status": "ok"}

ヘルスエンドポイントには資格情報は不要です。

認証パラメータの説明 (Authentication)

/mcp へのすべてのリクエストには、次の HTTP ヘッダーを含める必要があります:

3つのヘッダーのいずれかが欠けている場合は 401 Unauthorized を返します。

環境変数

logicmonitor-mcp には必須の環境変数はありません。すべての ID (company/access id/access key) はヘッダーを介してリクエストごとに指定されます。

MCP エンドポイント

POST http://localhost:8080/mcp

MCP クライアントを接続するには:

• トランスポート: http (Streamable HTTP / SSE)

• ヘッダー: X-LogicMonitor-Company, X-LogicMonitor-Access-Id, X-LogicMonitor-Access-Key (すべて必須)

ツール一覧

15 ツール — MSPbots のこの統合で既に登録されている 15 の LogicMonitor API エンドポイントに対応しています (sys_integration subject_code LOGICMONITOR)。そのため、ツールのカバレッジは MSPbots の既存のスコープと一致しています。すべてのツールは読み取り専用 (readOnlyHint=True) で、このサービスには書き込み/削除ツールはありません。

ページネーション: size のデフォルトは 50 で、サーバー側で 1000 のハードキャップに制限されます。これは LogicMonitor 自身が文書化/強制しているこのパラメータの最大値です (1000 を超える値は LogicMonitor 自身によって静かにクランプされ、それ以上を要求してもエラーにはならず、最大 1000 件が返されるだけです)。それとは別に、単一のツール応答は 20,000 文字に制限されます。結果のページがそれを超える場合、応答は完全に返されるのではなく、truncated/original_count フィールド付きで切り詰められます。

Devices (3)

Device DataSources (4)

Alerts (3)

Admin (2)

Reports (2)

SDT (1)

エラーハンドリング

ツールエラーは JSON 文字列として返されます (プロトコルレベルの例外ではありません)。そのため、エージェントはプログラム的に分岐できます:

{"error": {"code": "upstream_error", "message": "...", "retryable": true}}

code は固定の語彙のいずれかです: not_configured, unauthorized, not_found, invalid_argument, rate_limited, upstream_error。retryable は同じ呼び出しを再試行しても安全かどうかを示します (rate_limited/upstream_error の場合は true、それ以外は false)。

ネットワーク堅牢性

• 送信タイムアウト: 接続 5 秒 / 読み取り 30 秒 / 書き込み 10 秒 / プール 5 秒。

• 429/5xx に対して、上限付き指数バックオフによる限定的な再試行 (最大 3 回)。Retry-After が存在する場合はそれを尊重します。

• 各再試行では LMv1 署名をゼロから再計算します (現在のエポックが埋め込まれます)。そのため、再試行されたリクエストが古い/期限切れの署名で送信されることはありません。

• 単一の共有 httpx.AsyncClient 接続プールがプロセスの存続期間中再利用されます。

テスト例 (Test Example)

デバイスの一覧:

{
  "method": "tools/call",
  "params": { "name": "logicmonitor_get_devices", "arguments": { "size": 10 } }
}

実行中のサーバーに対する同等の curl (ストリーミング HTTP MCP エンドポイント):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-LogicMonitor-Company: <company>" \
  -H "X-LogicMonitor-Access-Id: <access_id>" \
  -H "X-LogicMonitor-Access-Key: <access_key>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "logicmonitor_get_devices", "arguments": { "size": 10 } }
  }'

パラメータ化された呼び出し:

{
  "method": "tools/call",
  "params": {
    "name": "logicmonitor_get_device_datasources",
    "arguments": { "device_id": "7186" }
  }
}

API リファレンス

• 公式ドキュメント: LogicMonitor REST API v3

• 認証スキーム: LMv1 API Tokens

• ベース URL パターン: https://{company}.logicmonitor.com/santaba/rest

既知のギャップ / 未検証

• 実際の LogicMonitor ポータルに対してはまだテストされていません。これまでに行われたのはプロトコルレベルの検証のみです (ヘルスチェック、ヘッダー欠落/部分的な場合の 401、tools/list が 15 ツールすべてを返すこと、ユニットテストされたエラーコードマッピング)。

• ツールのカバレッジは、LogicMonitor REST API の全表面 (書き込み操作、ダッシュボード、ウェブサイト、コレクター、LogicModules もカバー) ではなく、MSPbots の既存の登録済み 15 の LogicMonitor API エントリに意図的に一致しています。より広いカバレッジが必要な場合は、リクエストに応じて拡張します。