前言¶
運維和安全團隊日常要在 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 服務。
-
標準化 MCP 接口
外部 MCP 宿主連到 Kibana,使用你在 Agent Builder 中配置的工具(內置與自定義工具;部分僅適用於 Agent Builder 聊天的工具可能無法通過 MCP 暴露,以官方 built-in tools 說明爲準)。 -
固定端點形態
- 默認 Space:{KIBANA_URL}/api/agent_builder/mcp
- 自定義 Kibana Space:{KIBANA_URL}/s/{SPACE_NAME}/api/agent_builder/mcp
可在 Kibana Tools 界面複製 MCP 服務器 URL。 -
鑑權路徑
- API Key:適用於 Elastic Stack 與 Serverless,適合自動化、無人值守的機機訪問。
- OAuth 2.1(應用連接):Serverless 場景下適合 Claude Desktop、Cursor 等交互式宿主;多用戶各自授權。
缺少feature_agentBuilder.read等 Kibana 應用權限時,連接端點會得到403 Forbidden(見 API Key 文檔)。 -
跨項目數據
若通過 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 均已就緒的前提下,工作流通常分兩層:
-
Agent(Skill)層
根據用戶意圖選擇是否走 Kibana MCP:確認目標 Space、索引範圍、是否適合 API Key 還是 OAuth,並提醒最小權限(例如生產環境將 API Key 限制到logs-*、metrics-*等索引,官方 best practices 有完整 JSON 示例)。 -
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