Kibana

🚀 Kibana MCP 服務器

Kibana MCP 服務器允許任何 MCP 兼容客戶端（如 Claude Desktop）通過自然語言或程序化請求訪問您的 Kibana 實例，基於官方 Elastic Kibana API 文檔，使用 Elastic Stack 8.x (ES8) 的 OpenAPI YAML 規範動態獲取和管理所有 Kibana API 端點。

🚀 快速開始

構建項目

npm install

啟動服務器

node dist/index.js

配置 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"
            }
        }
    }
}

✨ 主要特性

• 動態 API 管理：使用 OpenAPI 規範動態獲取和管理所有 Kibana API 端點。
• 兼容性：支持與 Claude Desktop 等工具集成，提供基於工具和基於資源兩種交互模式。
• 安全性：支持身份驗證和權限控制，確保安全訪問 Kibana 實例。

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

自動重建（開發模式）

npm run watch

💻 使用示例

基礎用法

以下是一些示例查詢：

• "我的 Kibana 服務器狀態如何？"
• "列出所有可用的 Kibana API 端點。"
• "顯示 POST /api/saved_objects/_find 端點的詳細信息。"
• "執行自定義 API 請求以獲取 /api/status 的內容。"
• "獲取所有 Kibana 儀表板的列表。"
• "查詢與端點事件相關的 API 端點。"
• "列出所有與案例相關的 API 端點。"
• "在 Kibana 中創建新案例。"
• "在 Kibana 中創建新儀表板。"

高級用法

基於工具的提示模式

• 工作原理：Claude Desktop 可以直接調用服務器工具（如 get_status、execute_api、search_kibana_api_paths 等）來回答問題或執行操作。
• 適用場景：用戶希望獲得對話式、引導型體驗。服務器將自動搜索、執行並解釋 Kibana API。
• 示例："顯示所有與已保存對象相關的 Kibana API 端點。"

基於資源的提示模式

• 工作原理：Claude Desktop 通過資源 URI（如 kibana-api://paths 或 kibana-api://path/GET/%2Fapi%2Fstatus）與服務器交互，服務器返回結構化數據供 Claude 解析。
• 適用場景：高級用戶、僅支持資源訪問的 MCP 客戶端或需要原始 API 元數據的編程場景。

📚 詳細文檔

API 規範

該項目基於官方 Elastic Kibana API 文檔，並使用 Elastic Stack 8.x (ES8) 的 OpenAPI YAML 規範動態獲取和管理所有 Kibana API 端點。有關最新細節，請參閱 Kibana API 文檔。

開發

依賴安裝

npm install

項目構建

npm run build

自動重建（開發模式）

npm run watch

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能不太方便。推薦使用 MCP Inspector：

npm run inspector

啟動後，Inspector 會提供一個可通過瀏覽器訪問的調試工具 URL。

社區

該項目由社區維護。歡迎貢獻和反饋！請在所有交流中保持尊重和包容，並遵守 Elastic Community Code of Conduct。

故障排除

• 檢查 MCP 配置是否正確。
• 確保 Kibana 地址可以訪問。
• 驗證身份驗證憑據是否有足夠的權限。
• 如果使用自定義 CA，確保證書路徑正確且可讀。
• 如果使用 NODE_TLS_REJECT_UNAUTHORIZED=0，注意安全風險。
• 檢查終端輸出的錯誤信息。

📄 許可證

該項目 licensed under the Apache License 2.0。請參閱 LICENSE 文件獲取詳細信息。

⚠️ 重要提示 該項目由社區維護，並非 Elastic 或 MCP 的官方產品。

💡 使用建議 在使用 NODE_TLS_REJECT_UNAUTHORIZED=0 時，要特別注意安全風險。