kibana-mcp

kibana-mcp

Kibana / Elasticsearch 用の MCP サーバーです。Claude や MCP 対応の任意のエージェントから、ログ検索、集計、インデックスの検出、ダッシュボードの閲覧ができます。

なぜ別の Kibana MCP が必要なのですか？

既存の統合では、ブラウザーレベルの認証情報を使って Kibana インスタンスを起動しておく必要があり、多くの場合、安定した REST API ではなく Kibana UI をラップしています。このサーバーには次の特長があります。

• ログクエリには Elasticsearch REST API に直接アクセスします（高速で、Kibana UI の変更に左右されません）
• Elasticsearch の URL が直接設定されていない場合は、Kibana Console プロキシにフォールバックします（追加のファイアウォールルールは不要です）
• ApiKey 認証（エージェントに最適）に加えて、Basic 認証と匿名アクセスに対応しています
• 構造化 JSON（outputSchema）と Markdown テキストの両方を返すため、あらゆる MCP クライアントで利用できます
• 読み取り専用です。すべてのツールに readOnlyHint: true が設定されており、データは変更されません

ツール

ツール	API	説明
kibana_list_indices	GET ES/_cat/indices	ヘルス、ドキュメント数、サイズとともに利用可能なインデックスを検出します
kibana_search_logs	POST ES/{index}/_search	時間範囲、ソート、サイズを指定した全文ログ検索
kibana_aggregate_logs	POST ES/{index}/_search	件数、平均、合計、最小値、最大値の指標による用語グループ化
kibana_list_dashboards	GET Kibana/api/saved_objects/_find	検索とページネーションを使って保存済みダッシュボードを一覧表示します
kibana_get_dashboard	GET Kibana/api/saved_objects/dashboard/{id}	パネルの内訳とともに1つのダッシュボードを取得します

インストール

pip install kibana-mcp

または、uvx を使って直接実行します。

uvx kibana-mcp

設定

環境変数

変数	必須	説明
KIBANA_URL	はい	Kibana のベース URL（例：https://kibana.example.com）
ELASTICSEARCH_URL	いいえ	Elasticsearch の直接接続先。未設定の場合、Elasticsearch へのリクエストは Kibana Console プロキシ経由で送信されます
KIBANA_API_KEY	いいえ	Elasticsearch の API キー（ApiKey base64(id:api_key) 形式）。エージェントでの使用を推奨します
KIBANA_USERNAME	いいえ	HTTP Basic 認証のユーザー名（API キーが未設定の場合に使用）
KIBANA_PASSWORD	いいえ	HTTP Basic 認証のパスワード
KIBANA_SSL_VERIFY	いいえ	true（デフォルト）または、自己署名証明書の場合は false

認証の優先順位：ApiKey > Basic > 匿名。

.env.example を .env にコピーし、値を入力してください。

MCP クライアントの設定（Claude Desktop / claude.app）

{
  "mcpServers": {
    "kibana": {
      "command": "uvx",
      "args": ["kibana-mcp"],
      "env": {
        "KIBANA_URL": "https://kibana.example.com",
        "KIBANA_API_KEY": "your-api-key-here"
      }
    }
  }
}

パフォーマンスを高めるために Elasticsearch に直接アクセスする場合：

{
  "mcpServers": {
    "kibana": {
      "command": "uvx",
      "args": ["kibana-mcp"],
      "env": {
        "KIBANA_URL": "https://kibana.example.com",
        "ELASTICSEARCH_URL": "https://es.example.com:9200",
        "KIBANA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Docker

docker run --rm -i \
  -e KIBANA_URL=https://kibana.example.com \
  -e KIBANA_API_KEY=your-key \
  ghcr.io/mshegolev/kibana-mcp

使用例

ログ検索

Find the last 50 ERROR logs from the API service in the last hour

→ kibana_search_logs(index="logs-*", query="level:ERROR AND service:api", size=50, time_from="2026-04-18T09:00:00Z")

Show 500 HTTP errors sorted oldest first for incident replay

→ kibana_search_logs(index="nginx-*", query="status:500", sort_order="asc", size=100)

集計

How many logs per log level in the last hour?

→ kibana_aggregate_logs(index="logs-*", group_by="level", time_from="2026-04-18T09:00:00Z")

What is the average response time per service?

→ kibana_aggregate_logs(index="logs-*", group_by="service.keyword", metric="avg", metric_field="response_time_ms")

インデックスの検出

What log indices are available?

→ kibana_list_indices()

Show me all filebeat indices

→ kibana_list_indices(pattern="filebeat-*")

ダッシュボード

Find the infrastructure dashboard

→ kibana_list_dashboards(search="infrastructure")

What panels does dashboard X have?

→ kibana_get_dashboard(dashboard_id="<id from list_dashboards>")

パフォーマンス特性

• ログ検索（kibana_search_logs）：ES の URL に直接接続する場合は通常 50～500ms です。Kibana Console プロキシ経由の場合は、さらに 100～200ms かかります。
• 集計（kibana_aggregate_logs）：size:0 クエリではヒットを転送しないため、通常 10～100ms です。
• インデックス一覧の取得：単一の _cat/indices 呼び出しで、レスポンスのサイズは O(index_count) です。通常 100ms 未満です。
• ダッシュボード API：Kibana Saved Objects API を使用します。通常 50～200ms で、レイテンシーはネットワークではなく Kibana 側で発生します。
• エージェントが頻繁にログ検索を行う場合は、ELASTICSEARCH_URL を直接設定してください。プロキシによるオーバーヘッドを解消できます。

開発

git clone https://github.com/mshegolev/kibana-mcp
cd kibana-mcp
pip install -e '.[dev]'
pytest tests/ -v
ruff check src tests
ruff format src tests

ライセンス

MIT — LICENSE を参照してください。