Kibana

🚀 Kibana MCP サーバー

Kibana MCP サーバーは、Claude Desktop などの MCP 互換クライアントが自然言語またはプログラムによるリクエストで Kibana インスタンスにアクセスできるようにする実装です。このプロジェクトは、公式の Elastic Kibana API ドキュメントに基づいており、Elastic Stack 8.x (ES8) の OpenAPI YAML 仕様を使用して、すべての Kibana API エンドポイントを動的に取得および管理します。最新の詳細については、Kibana API ドキュメントを参照してください。

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

✨ 主な機能

• 動的 API 管理：OpenAPI 仕様を使用して、すべての Kibana API エンドポイントを動的に取得および管理します。
• 互換性：Claude Desktop などのツールとの統合をサポートし、ツールベースとリソースベースの 2 つの対話モードを提供します。
• セキュリティ：認証と権限管理をサポートし、Kibana インスタンスへの安全なアクセスを確保します。

📦 インストール

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築（開発モード）

npm run watch

🚀 クイックスタート

1. プロジェクトのビルド

   npm install
   

2. サーバーの起動

   node dist/index.js
   

3. MCP サーバーの設定 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 リクエストを実行して /api/status の内容を取得してください。"
• "すべての Kibana ダッシュボードのリストを取得してください。"
• "エンドポイントイベントに関連する API エンドポイントをクエリしてください。"
• "すべてのケース関連の API エンドポイントをリストしてください。"
• "Kibana で新しいケースを作成してください。"
• "Kibana で新しいダッシュボードを作成してください。"

2 つの対話モード

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

• 動作原理：Claude Desktop は、サーバーツール（get_status、execute_api、search_kibana_api_paths など）を直接呼び出して、質問に回答したり操作を実行したりできます。
• 適用シナリオ：ユーザーが対話型、ガイド付きの体験を望む場合。サーバーは自動的に Kibana API を検索、実行、解釈します。
• 例："すべての保存済みオブジェクトに関連する Kibana API エンドポイントを表示してください。"

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

• 動作原理：Claude Desktop は、リソース URI（kibana-api://paths または kibana-api://path/GET/%2Fapi%2Fstatus など）を介してサーバーとやり取りし、サーバーは Claude が解析するための構造化データを返します。
• 適用シナリオ：上級ユーザー、リソースアクセスのみをサポートする MCP クライアント、または生の API メタデータが必要なプログラミングシナリオ。

🔧 開発

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

自動再構築（開発モード）

npm run watch

🔍 デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグは容易ではない場合があります。MCP Inspector の使用をおすすめします。

npm run inspector

起動後、Inspector はブラウザでアクセスできるデバッグツールの URL を提供します。

👥 コミュニティ

このプロジェクトはコミュニティによってメンテナンスされています。貢献とフィードバックを歓迎します！すべてのコミュニケーションでは、敬意と包容力を持って行い、Elastic Community Code of Conduct に従ってください。

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

❓ トラブルシューティング

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