Kibana MCP

🚀 Kibana-MCP サーバードキュメント

Kibana-MCP サーバーのセットアップ、構築、テストに関する手順を提供します。

📦 インストール

依存関係のインストール

uv を使用して依存関係を同期します。

uv sync

🚀 ビルドとリリース

リリースバージョンの準備

1. ソフトウェアパッケージのビルド

   uv build
   

   このコマンドは dist/ ディレクトリにソースコードとバイナリパッケージを生成します。
2. PyPI へのリリース

   uv publish
   

   ⚠️ 重要提示

   PyPI の認証情報を事前に設定する必要があります。

💻 開発環境とテスト

依存関係のインストール

開発用の依存関係をインストールします。

pip install -r requirements-dev.txt

クイックスタートスクリプト

プロジェクトのルートディレクトリからクイックスタートスクリプトを実行します。

./testing/quickstart-test-env.sh

このスクリプト (testing/main.py) は以下の操作を実行します。

1. Docker と Docker Compose のインストールを確認します。
2. testing/docker-compose.yml の設定を解析します。
3. docker compose up -d を実行します。
4. Elasticsearch と Kibana API が起動するのを待ちます。
5. Kibana 内部で使用するカスタムユーザー (kibana_system_user) とロールを作成します。
6. インデックステンプレート (mcp_auth_logs_template) を作成します。
7. testing/sample_rule.json（検出ルール）を読み取り、http://localhost:5601/api/detection_engine/rules に POST リクエストを送信してルールを作成します。
8. testing/auth_events.ndjson のサンプルデータを mcp-auth-logs-default インデックスに書き込みます。
9. http://localhost:5601/api/detection_engine/signals/search で検出信号を確認します。
10. ステータス、URL、認証情報、および停止コマンドを表示します。

テスト環境の停止

スクリプトが表示する停止コマンド（例：docker compose -f testing/docker-compose.yml down）を実行します。データボリュームを削除する場合は -v フラグ (down -v) を使用してください。