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
类型安全、可扩展且易于集成

目录结构

├── index.ts                # Server entry point
├── src/
│   ├── types.ts            # Type definitions and schemas
│   ├── base-tools.ts       # Tool registration and API logic
│   ├── prompts.ts          # Prompt registration (expert & resource helper)
│   └── resources.ts        # Resource registration (API paths/URIs)
├── kibana-openapi-source.yaml # Kibana API OpenAPI index
├── README.md               # English documentation
├── README_zh.md            # Chinese documentation

资源

资源 URI	描述
`kibana-api://paths`	返回所有可用的 Kibana API 端点（可以使用`search`参数进行过滤）
`kibana-api://path/{method}/{encoded_path}`	返回特定 API 端点的详细信息

例子：

kibana-api://paths?search=saved_objects
kibana-api://path/GET//api/status

工具

工具名称	描述	输入参数
`get_status`	获取 Kibana 服务器的当前状态	没有任何
`execute_api`	执行自定义 Kibana API 请求	`method` （GET/POST/PUT/DELETE）、 `path` （字符串）、 `body` （可选）、 `params` （可选）
`search_kibana_api_paths`	按关键字搜索 Kibana API 端点	`search` （字符串）
`list_all_kibana_api_paths`	列出所有 Kibana API 端点	没有任何
`get_kibana_api_detail`	获取特定 Kibana API 端点的详细信息	`method` （字符串）， `path` （字符串）

提示

提示名称	描述
`kibana-tool-expert`	工具专家模式（强烈推荐在 Claude Desktop 中使用），支持通过工具对 Kibana API 进行智能分析、搜索、执行和解释。推荐大多数用户使用。
`kibana-resource-helper`	资源助手模式，指导如何通过资源 URI 访问和使用 Kibana API 信息。适用于仅支持资源访问或需要原始 API 元数据的客户端。

配置

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

变量名称	描述	必需的
`KIBANA_URL`	Kibana 服务器地址（例如http://localhost:5601 ）	是的
`KIBANA_USERNAME`	Kibana 用户名	是的
`KIBANA_PASSWORD`	Kibana 密码	是的
`KIBANA_CA_CERT`	CA 证书路径（可选，用于 SSL 验证）	不
`KIBANA_TIMEOUT`	请求超时（毫秒）（默认 30000）	不
`KIBANA_MAX_RETRIES`	最大请求重试次数（默认 3 次）	不
`NODE_TLS_REJECT_UNAUTHORIZED`	设置为`0`以禁用 SSL 证书验证（谨慎使用）	不

用法

启动服务器

KIBANA_URL=http://your-kibana-server:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npm start

MCP 客户端配置示例

添加到 Claude Desktop 配置文件（MacOS 路径： ~/Library/Application Support/Claude/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"
      }
    }
  }
}

示例查询

“我的 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//api/status ）与服务器交互，服务器返回结构化数据供 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 交互。

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

发展

安装依赖项：

npm install

构建服务器：

npm run build

在开发模式下自动重建：

npm run watch

调试

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

npm run inspector

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

社区

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

执照

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

故障排除

检查MCP配置是否正确
确保 Kibana 地址可以访问
验证身份验证凭据是否具有足够的权限
如果使用自定义 CA，请确保证书路径正确且可读
如果使用NODE_TLS_REJECT_UNAUTHORIZED=0 ，请注意安全风险
检查终端输出的错误消息

Kibana MCP Server