kibana-mcp

用于 Kibana / Elasticsearch 的 MCP 服务器 — 通过 Claude 和任何兼容 MCP 的代理进行日志搜索、聚合、索引发现和仪表板浏览。

为什么需要另一个 Kibana MCP？

现有的集成通常需要一个运行中的 Kibana 实例，并使用浏览器级别的凭据，且往往是封装 Kibana UI 而非稳定的 REST API。本服务器：

• 直接访问 Elasticsearch REST API 进行日志查询（速度更快，在 Kibana UI 变更时依然稳定）

• 在未配置直接 ES URL 时，回退至 Kibana 控制台代理（无需额外的防火墙规则）

• 支持 ApiKey 认证（最适合代理）以及基本认证和匿名访问

• 同时返回 结构化 JSON (outputSchema) 和 Markdown 文本，因此适用于任何 MCP 客户端

• 是 只读的 — 所有工具均带有 readOnlyHint: true，不会修改任何数据

工具

安装

pip install kibana-mcp

或者直接使用 uvx 运行：

uvx kibana-mcp

配置

环境变量

认证优先级：ApiKey > 基本认证 > 匿名。

将 .env.example 复制为 .env 并填入您的值。

MCP 客户端配置 (Claude Desktop / claude.app)

{
  "mcpServers": {
    "kibana": {
      "command": "uvx",
      "args": ["kibana-mcp"],
      "env": {
        "KIBANA_URL": "https://kibana.example.com",
        "KIBANA_API_KEY": "your-api-key-here"
      }
    }
  }
}

或者使用直接 ES 访问以获得更好的性能：

{
  "mcpServers": {
    "kibana": {
      "command": "uvx",
      "args": ["kibana-mcp"],
      "env": {
        "KIBANA_URL": "https://kibana.example.com",
        "ELASTICSEARCH_URL": "https://es.example.com:9200",
        "KIBANA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Docker

docker run --rm -i \
  -e KIBANA_URL=https://kibana.example.com \
  -e KIBANA_API_KEY=your-key \
  ghcr.io/mshegolev/kibana-mcp

使用示例

日志搜索

Find the last 50 ERROR logs from the API service in the last hour

→ kibana_search_logs(index="logs-*", query="level:ERROR AND service:api", size=50, time_from="2026-04-18T09:00:00Z")

Show 500 HTTP errors sorted oldest first for incident replay

→ kibana_search_logs(index="nginx-*", query="status:500", sort_order="asc", size=100)

聚合

How many logs per log level in the last hour?

→ kibana_aggregate_logs(index="logs-*", group_by="level", time_from="2026-04-18T09:00:00Z")

What is the average response time per service?

→ kibana_aggregate_logs(index="logs-*", group_by="service.keyword", metric="avg", metric_field="response_time_ms")

索引发现

What log indices are available?

→ kibana_list_indices()

Show me all filebeat indices

→ kibana_list_indices(pattern="filebeat-*")

仪表板

Find the infrastructure dashboard

→ kibana_list_dashboards(search="infrastructure")

What panels does dashboard X have?

→ kibana_get_dashboard(dashboard_id="<id from list_dashboards>")

性能特征

• 日志搜索 (kibana_search_logs)：使用直接 ES URL 时通常为 50-500ms；通过 Kibana 控制台代理路由时增加 100-200ms

• 聚合 (kibana_aggregate_logs)：size:0 查询 — 无需传输命中结果，通常为 10-100ms

• 索引列表：单次 _cat/indices 调用，响应时间为 O(index_count)，通常 <100ms

• 仪表板 API：Kibana Saved Objects API，通常为 50-200ms；延迟主要在 Kibana 端，而非网络

• 如果您的代理需要频繁进行日志搜索，请直接设置 ELASTICSEARCH_URL — 可消除代理开销

开发

git clone https://github.com/mshegolev/kibana-mcp
cd kibana-mcp
pip install -e '.[dev]'
pytest tests/ -v
ruff check src tests
ruff format src tests

许可证

MIT — 参见 LICENSE。