Kibana MCP

🚀 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（一個檢測規則）併發送 POST 請求到 http://localhost:5601/api/detection_engine/rules 創建規則。
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) 來移除數據卷。