Kibana MCP 服务器

API 规范

本项目基于 Elastic Kibana 官方 API 文档，并使用 Elastic Stack 8.x (ES8) 的 OpenAPI YAML 规范来动态检索和管理所有 Kibana API 端点。如需了解最新详情，请参阅Kibana API 文档。

Kibana MCP 服务器实现允许任何与 MCP 兼容的客户端（例如 Claude Desktop）通过自然语言或编程请求访问您的 Kibana 实例。

该项目由社区维护，不是 Elastic 或 MCP 的官方产品。

特征

• 连接到本地或远程 Kibana 实例

• 安全认证（用户名/密码）

• SSL/TLS 和自定义 CA 证书支持

• 将 Kibana API 端点公开为工具和资源

• 从 MCP 客户端搜索、查看和执行 Kibana API

• 类型安全、可扩展且易于集成

目录结构

资源

例子：

• kibana-api://paths?search=saved_objects

• kibana-api://path/GET/%2Fapi%2Fstatus

工具

提示

配置

通过环境变量配置服务器：

用法

启动服务器

MCP 客户端配置示例

添加到 Claude Desktop 配置文件（MacOS 路径： ~/Library/Application Support/Claude/claude_desktop_config.json ）：

示例查询

• “我的 Kibana 服务器状态如何？”

• “列出所有可用的 Kibana API 端点。”

• “显示 POST /api/saved_objects/_find 端点的详细信息。”

• “对 /api/status 执行自定义 API 请求。”

• “获取 Kibana 中所有仪表板的列表。”

• “查询与端点事件相关的 API 端点。”

• “列出所有与案件相关的 API 端点。”

• “在 Kibana 中创建新案例。”

• “在 Kibana 中创建一个新的仪表板。”

Claude Desktop 中的两种提示模式

当将此服务器与 Claude Desktop 一起使用时，支持两种不同的提示交互模式：

1.基于工具的提示模式

• 工作原理： Claude Desktop 可以直接调用服务器工具（例如get_status 、 execute_api 、 search_kibana_api_paths等）来回答您的问题或执行操作。

• **最适合：**需要对话式引导式体验的用户。服务器将自动搜索、执行并解释 Kibana API。

• 示例： “显示与已保存对象相关的所有 Kibana API 端点。”

• **测试提示：**选择Claude Desktop中的kibana-tool-expert提示进行集成测试，然后开始使用它。

2.基于资源的提示模式

• 工作原理： Claude Desktop 通过资源 URI（例如kibana-api://paths或kibana-api://path/GET/%2Fapi%2Fstatus ）与服务器交互，服务器返回结构化数据供 Claude 解析。

• **最适合：**高级用户、仅支持资源访问的 MCP 客户端或需要原始 API 元数据的编程场景。

• 示例： “获取资源 kibana-api://paths?search=dashboard”

注意： resources中的两个端点（ kibana-api://paths和kibana-api://path/{method}/{encoded_path} ）都有对应的基础工具（ list_all_kibana_api_paths 、 get_kibana_api_detail ）。这样的设计确保了与无法智能选择多个资源的 MCP 客户端兼容，从而让 Claude Desktop 等工具更容易与 Kibana 交互。

**提示：**建议大多数用户使用工具模式以获得更自然、更强大的体验；资源模式为高级和兼容性用例提供了最大的灵活性。

发展

安装依赖项：

构建服务器：

在开发模式下自动重建：

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能不太方便。建议使用 MCP Inspector：

启动后，Inspector会提供一个浏览器可以访问的调试工具URL。

社区

本项目由社区维护。欢迎贡献和反馈！请在所有沟通中保持尊重和包容的态度，并遵守Elastic 社区行为准则。

执照

本项目遵循 Apache License 2.0 许可协议。详情请参阅LICENSE文件。

故障排除

• 检查MCP配置是否正确

• 确保 Kibana 地址可以访问

• 验证身份验证凭据是否具有足够的权限

• 如果使用自定义 CA，请确保证书路径正确且可读

• 如果使用NODE_TLS_REJECT_UNAUTHORIZED=0 ，请注意安全风险

• 检查终端输出的错误消息