Elastic / Kibana MCP 服務器 Skill:把 Kibana Agent Builder 接到 MCP 宿主

前言

運維和安全團隊日常要在 Kibana 裏查日誌、跑 ES|QL、用 Agent Builder 工具。若希望 Cursor、Claude Desktop 等 MCP 宿主直接調用同一套能力,需要知道 Kibana 暴露的 MCP 端點、鑑權方式和客戶端配置格式,而不是每次手工翻文檔拼 JSON。

下面介紹的 Skill 來自 SkillHub 社區座標 @user_3c6cb52e/elastic-kibana-mcp-server(v1.0.0,分類 it-ops-security)。它本身不單獨實現 MCP 服務,而是把 Agent 引導到 Elastic 官方的 Agent Builder MCP 能力與文檔;Skill 包內的 SKILL.md 也寫明未能自動抽取完整安裝步驟,敏感環境應先覈對上游再啓用。

這是什麼

一句話定位: 面向大模型 Agent 的 Skill 條目,主題是通過 Model Context Protocol 連接 Kibana 上的 Elastic Agent Builder MCP 服務器。

維護與來源: SkillHub 頁面顯示發佈者爲 user_3c6cb52e,來源爲 community;Skill 元數據將上游指向 elastic/elasticsearch,並引用 Elasticsearch 參考文檔。實際 MCP 行爲由 Elastic Stack / Elastic Cloud 中的 Kibana Agent Builder 提供,而非 Skill 目錄裏再裝一個獨立二進制。

解決的問題: 讓 Agent 在對話中遵循統一說明——端點路徑、Space、鑑權選項——去配置 MCP 宿主,從而在外部客戶端裏使用 Agent Builder 工具(官方文檔舉例:在 Claude Desktop 中執行 ES|QL 而無需打開 Kibana UI)。

核心功能

以下能力來自 Elastic Agent Builder MCP server 官方說明,Skill 的作用是把這些約束寫進 Agent 的工作流,而不是替代 Kibana 服務。

  1. 標準化 MCP 接口
    外部 MCP 宿主連到 Kibana,使用你在 Agent Builder 中配置的工具(內置與自定義工具;部分僅適用於 Agent Builder 聊天的工具可能無法通過 MCP 暴露,以官方 built-in tools 說明爲準)。

  2. 固定端點形態
    - 默認 Space:{KIBANA_URL}/api/agent_builder/mcp
    - 自定義 Kibana Space:{KIBANA_URL}/s/{SPACE_NAME}/api/agent_builder/mcp
    可在 Kibana Tools 界面複製 MCP 服務器 URL。

  3. 鑑權路徑
    - API Key:適用於 Elastic Stack 與 Serverless,適合自動化、無人值守的機機訪問。
    - OAuth 2.1(應用連接):Serverless 場景下適合 Claude Desktop、Cursor 等交互式宿主;多用戶各自授權。
    缺少 feature_agentBuilder.read 等 Kibana 應用權限時,連接端點會得到 403 Forbidden(見 API Key 文檔)。

  4. 跨項目數據
    若通過 cross-project search 關聯多個項目,工具調用會使用 MCP URL 對應 Space 的默認跨項目搜索範圍;URL 不含 /s/{SPACE} 時使用 default space。

SkillHub 標籤 requires_api_key=false 表示安裝該 Skill 時不需要 SkillHub 的 API Key;連接 Kibana MCP 仍須按 Elastic 文檔配置 API Key 或 OAuth。

安裝與啓用

1. 安裝 SkillHub CLI(若尚未安裝)

按 SkillHub 安裝說明 檢查或安裝:

command -v skillhub && skillhub --version

未安裝時可執行完整安裝腳本(文檔中的推薦方式):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 將 Skill 裝入當前 Agent 的 skills 目錄

SkillHub 頁面給出的安裝提示爲:依據上述安裝文檔,安裝座標 @user_3c6cb52e/elastic-kibana-mcp-server。命令形態如下(--dir 必須指向當前宿主識別的 skills 目錄,否則默認落在 ./skills/ 且可能不被加載):

skillhub install @user_3c6cb52e/elastic-kibana-mcp-server --dir <skills 目錄>

常見路徑(摘自 SkillHub 安裝文檔):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或項目下的 .agents/skills/

安裝後按你所用客戶端要求重啓或刷新 Agent,使 SKILL.md 生效。

3. 在 MCP 宿主側配置 Kibana(與 Skill 並列的必要步驟)

Skill 包內未提供可自動驗證的一鍵安裝腳本;真正打通查詢能力的是 MCP 宿主對 Kibana 的配置。Elastic 文檔給出的 API Key 方式示例(適用於 Claude Desktop、Cursor、VS Code 等)如下。

先創建具備 Agent Builder 讀權限的 API Key(節選,完整字段見官方文檔):

POST /_security/api_key
{
  "name": "my-mcp-api-key",
  "expiration": "30d",
  "role_descriptors": {
    "mcp-access": {
      "cluster": ["monitor_inference"],
      "indices": [
        {
          "names": ["*"],
          "privileges": ["read", "view_index_metadata"]
        }
      ],
      "applications": [
        {
          "application": "kibana-.kibana",
          "privileges": ["feature_agentBuilder.read", "feature_actions.read"],
          "resources": ["space:default"]
        }
      ]
    }
  }
}

在 MCP 配置中加入遠程端點(通過 mcp-remote 轉發請求頭):

{
  "mcpServers": {
    "elastic-agent-builder": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "${KIBANA_URL}/api/agent_builder/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "KIBANA_URL": "${KIBANA_URL}",
        "AUTH_HEADER": "ApiKey ${API_KEY}"
      }
    }
  }
}

環境變量示例:

export KIBANA_URL="your-kibana-url"
export API_KEY="your-api-key"

若使用自定義 Space,將 URL 中的路徑替換爲 /s/{SPACE_NAME}/api/agent_builder/mcp。Serverless 且需要多人各自身份時,可改用文檔中的 OAuth 2.1 應用連接流程。

典型用法

在 Skill 與 MCP 均已就緒的前提下,工作流通常分兩層:

  1. Agent(Skill)層
    根據用戶意圖選擇是否走 Kibana MCP:確認目標 Space、索引範圍、是否適合 API Key 還是 OAuth,並提醒最小權限(例如生產環境將 API Key 限制到 logs-*、metrics-* 等索引,官方 best practices 有完整 JSON 示例)。

  2. MCP 工具層
    宿主連上 {KIBANA_URL}/api/agent_builder/mcp 後,調用 Elastic Agent Builder 暴露的工具。官方文檔舉例:在外部客戶端中對你的數據運行 ES|QL,而無需打開 Kibana。

具體工具名稱與參數以當前 Elastic 版本和項目中啓用的 Agent Builder 工具爲準;Agent 應先讀 Skill 與 Elastic 文檔,避免臆造索引名或字段名。

適用場景與注意

適合誰

  • 已部署 Elastic Stack 9.3+(或 9.2 預覽)或 Elastic Cloud Serverless,並啓用 Agent Builder 的團隊。
  • 希望在 Cursor / Claude Desktop / VS Code 等 MCP 宿主裏複用 Kibana 側工具,同時用 Skill 約束 Agent 的配置與合規檢查步驟。
  • SkillHub 分類 it-ops-security 所覆蓋的觀測、安全運維類對話場景。

限制與坑

  • Skill 正文明確:沒有自動抽取、未經上游背書的安裝與用法不應在敏感流程中直接執行;生產前務必對照 MCP server 與 API Key 鑑權 原文。
  • MCP 與 Skill 是兩層:只裝 Skill 不會自動出現 Kibana 連接;只配 MCP 而不裝 Skill,Agent 也可能缺少索引權限與端點格式的提醒。
  • API Key 需包含 feature_agentBuilder.read,並建議設置過期時間與最小索引權限。
  • SkillHub 統計(抓取時):評分 100000,下載 1209,安裝計數 0;以頁面實時數據爲準。

結尾

Elastic / Kibana MCP 服務器 Skill 的價值在於:把 Kibana Agent Builder MCP 的端點、鑑權與客戶端配置收斂成 Agent 可執行的說明,並與 SkillHub 安裝流程 @user_3c6cb52e/elastic-kibana-mcp-server 對齊。能力本身仍由 Elastic 官方 MCP 服務提供。

  • SkillHub API 條目:https://api.skillhub.cn/user_3c6cb52e/elastic-kibana-mcp-server
  • SkillHub 頁面:https://www.skillhub.cn/skills/user_3c6cb52e/elastic-kibana-mcp-server
  • Elastic MCP 文檔:https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/mcp-server
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜