Kibana MCP サーバー

API仕様
このプロジェクトはElastic Kibanaの公式APIドキュメントに基づいており、Elastic Stack 8.x（ES8）のOpenAPI YAML仕様を使用して、すべてのKibana APIエンドポイントを動的に取得および管理します。最新の詳細については、 Kibana APIドキュメントをご覧ください。

MCP 互換クライアント (Claude Desktop など) が自然言語またはプログラムによるリクエストを介して Kibana インスタンスにアクセスできるようにする Kibana MCP サーバー実装。

このプロジェクトはコミュニティによって維持されており、Elastic または MCP の公式製品ではありません。

特徴

ローカルまたはリモートの Kibana インスタンスに接続する
安全な認証（ユーザー名/パスワード）
SSL/TLS およびカスタム CA 証明書のサポート
Kibana APIエンドポイントをツールとリソースの両方として公開します
MCP クライアントから Kibana API を検索、表示、実行する
型安全、拡張可能、統合が容易

ディレクトリ構造

├── index.ts                # Server entry point
├── src/
│   ├── types.ts            # Type definitions and schemas
│   ├── base-tools.ts       # Tool registration and API logic
│   ├── prompts.ts          # Prompt registration (expert & resource helper)
│   └── resources.ts        # Resource registration (API paths/URIs)
├── kibana-openapi-source.yaml # Kibana API OpenAPI index
├── README.md               # English documentation
├── README_zh.md            # Chinese documentation

リソース

リソースURI	説明
`kibana-api://paths`	利用可能なすべての Kibana API エンドポイントを返します ( `search`パラメータでフィルタリングできます)
`kibana-api://path/{method}/{encoded_path}`	特定のAPIエンドポイントの詳細を返します

例:

kibana-api://paths?search=saved_objects
kibana-api://path/GET//api/status

ツール

ツール名	説明	入力パラメータ
`get_status`	Kibanaサーバーの現在のステータスを取得する	なし
`execute_api`	カスタム Kibana API リクエストを実行する	`method` （GET/POST/PUT/DELETE）、 `path` （文字列）、 `body` （オプション）、 `params` （オプション）
`search_kibana_api_paths`	Kibana APIエンドポイントをキーワードで検索	`search` （文字列）
`list_all_kibana_api_paths`	すべての Kibana API エンドポイントを一覧表示する	なし
`get_kibana_api_detail`	特定の Kibana API エンドポイントの詳細を取得する	`method` （文字列）、 `path` （文字列）

プロンプト

プロンプト名	説明
`kibana-tool-expert`	ツールエキスパートモード（Claude Desktopでは強く推奨）は、ツールを介してKibana APIのインテリジェントな分析、検索、実行、説明をサポートします。ほとんどのユーザーに推奨されます。
`kibana-resource-helper`	リソースヘルパーモードは、リソースURIを介してKibana API情報にアクセスし、使用する方法をガイドします。リソースアクセスのみをサポートするクライアント、または生のAPIメタデータを必要とするクライアントに適しています。

構成

環境変数を使用してサーバーを構成します。

変数名	説明	必須
`KIBANA_URL`	Kibanaサーバーのアドレス（例：http://localhost:5601 ）	はい
`KIBANA_USERNAME`	Kibanaのユーザー名	はい
`KIBANA_PASSWORD`	Kibanaのパスワード	はい
`KIBANA_CA_CERT`	CA 証明書パス（オプション、SSL 検証用）	いいえ
`KIBANA_TIMEOUT`	リクエストタイムアウト（ミリ秒）（デフォルト 30000）	いいえ
`KIBANA_MAX_RETRIES`	最大リクエスト再試行回数（デフォルト 3）	いいえ
`NODE_TLS_REJECT_UNAUTHORIZED`	SSL証明書の検証を無効にするには`0`に設定します（注意して使用してください）	いいえ

使用法

サーバーを起動する

KIBANA_URL=http://your-kibana-server:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npm start

MCPクライアント構成の例

Claude Desktop 構成ファイル (MacOS パス: ~/Library/Application Support/Claude/claude_desktop_config.json ) に追加します。

{
  "mcpServers": {
    "kibana-mcp-server": {
      "command": "node",
      "args": ["/path/to/mcp-server-kibana/dist/index.js"],
      "env": {
        "KIBANA_URL": "http://your-kibana-server:5601",
        "KIBANA_USERNAME": "your-username",
        "KIBANA_PASSWORD": "your-password",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

クエリの例

「Kibana サーバーの状態はどうですか?」
「利用可能なすべての Kibana API エンドポイントを一覧表示します。」
「POST /api/saved_objects/_find エンドポイントの詳細を表示します。」
「/api/status のカスタム API リクエストを実行します。」
「Kibana のすべてのダッシュボードのリストを取得します。」
「エンドポイントイベントに関連する API エンドポイントをクエリします。」
「ケース関連の API エンドポイントをすべて一覧表示します。」
「Kibana で新しいケースを作成します。」
「Kibana で新しいダッシュボードを作成します。」

Claude Desktop の 2 つのプロンプトモード

このサーバーを Claude Desktop で使用する場合、次の 2 つの異なるプロンプト対話モードがサポートされます。

1. ツールベースのプロンプトモード

仕組み: Claude Desktop は、サーバーツール ( get_status 、 execute_api 、 search_kibana_api_pathsなど) を直接呼び出して、質問に答えたりアクションを実行したりできます。
**最適なユーザー：**会話型のガイド付きエクスペリエンスを求めるユーザー。サーバーがKibana APIを自動的に検索、実行し、解説します。
例: 「保存されたオブジェクトに関連するすべての Kibana API エンドポイントを表示します。」
**テストのヒント:**統合テストのために、Claude Desktop でkibana-tool-expertプロンプトを選択し、使用を開始します。

2. リソースベースのプロンプトモード

仕組み: Claude Desktop はリソース URI ( kibana-api://pathsやkibana-api://path/GET//api/statusなど) を介してサーバーと対話し、サーバーは Claude が解析するための構造化データを返します。
**最適な対象:**上級ユーザー、リソースアクセスのみをサポートする MCP クライアント、または生の API メタデータを必要とするプログラミングシナリオ。
例: 「リソース kibana-api://paths?search=dashboard を取得する」

注: resources内の2つのエンドポイント ( kibana-api://pathsとkibana-api://path/{method}/{encoded_path} ) には、対応するベースツール ( list_all_kibana_api_paths 、 get_kibana_api_detail ) があります。この設計により、複数のリソースをインテリジェントに選択できないMCPクライアントとの互換性が確保され、Claude DesktopなどのツールがKibanaと連携しやすくなります。

**ヒント:**より自然で強力なエクスペリエンスを得るには、ほとんどのユーザーにはツールモードの使用が推奨されます。リソースモードは、高度なユースケースや互換性のあるユースケースに最大限の柔軟性を提供します。

発達

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

開発モードでの自動再構築:

npm run watch

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが不便になる場合があります。MCP Inspectorの使用をお勧めします。

npm run inspector

起動すると、Inspector はブラウザからアクセス可能なデバッグツールの URL を提供します。

コミュニティ

このプロジェクトはコミュニティによって維持されています。貢献とフィードバックを歓迎します。すべてのコミュニケーションにおいて、敬意と包摂性を持ち、 Elasticコミュニティ行動規範を遵守してください。

ライセンス

このプロジェクトはApache License 2.0に基づいてライセンスされています。詳細はLICENSEファイルをご覧ください。

トラブルシューティング

MCP構成が正しいか確認する
Kibanaアドレスにアクセスできることを確認する
認証資格情報に十分な権限があることを確認する
カスタムCAを使用する場合は、証明書パスが正しく読み取り可能であることを確認してください。
NODE_TLS_REJECT_UNAUTHORIZED=0使用する場合は、セキュリティリスクに注意してください
ターミナルに出力されたエラーメッセージを確認する

Kibana MCP Server