{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_h5fxq4vy9ff8","handle":"kibana-mcp-server","url":"https://wellknown.network/agents/kibana-mcp-server","links":{"self":"https://wellknown.network/agents/kibana-mcp-server/record.json","html":"https://wellknown.network/agents/kibana-mcp-server","markdown":"https://wellknown.network/agents/kibana-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/kibana-mcp-server","status":"https://wellknown.network/api/v1/agents/kibana-mcp-server/status","claim":"https://wellknown.network/agents/kibana-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/kibana-mcp-server/claim.json","badge":"https://wellknown.network/agents/kibana-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/kibana-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/kibana-mcp-server/tools"},"ard":{"identifier":"urn:air::server:kibana-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"kibana-mcp-server","summary":"MCP Server for Kibana log querying with automatic authentication","description":"# Kibana MCP Server\n\n🔍 **Kibana 日志查询 MCP Server** - 提供自动认证、会话管理和多种日志查询工具\n\n## 功能特性\n\n✅ **自动认证管理**\n- 自动根据 `KIBANA_USERNAME` 和 `KIBANA_PASSWORD` 环境变量登录\n- 自动获取并管理 `sid` cookie\n- 会话过期自动续期\n- 401 错误透明处理并重新登录\n\n✅ **丰富的查询工具**\n- 日志搜索（关键词查询 + DSL 查询）\n- 聚合统计（按服务、按时间）\n- 错误日志快速搜索\n- 原始 Elasticsearch DSL 查询\n\n## 安装\n\n```bash\n# 1. 安装 Python 依赖\npip install -r requirements.txt\n\n# 或使用 uv (推荐)\nuv pip install -r requirements.txt\n```\n\n## 运行方式 (推荐使用 uvx)\n\n你可以直接使用 `uvx` 从本地目录运行：\n\n```bash\nuvx --from /tmp/kibana-mcp-server kibana-mcp-server\n```\n\n## 配置 MCP\n\n### Claude Desktop / OpenCode 配置\n\n```json\n{\n  \"mcpServers\": {\n    \"kibana\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"/tmp/kibana-mcp-server\",\n        \"kibana-mcp-server\"\n      ],\n      \"env\": {\n        \"KIBANA_URL\": \"https://logs.example.com\",\n        \"KIBANA_VERSION\": \"8.17.1\",\n        \"KIBANA_USERNAME\": \"your_username\",\n        \"KIBANA_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### 1. `kibana_search_logs`\n搜索日志（支持关键词搜索和完整 DSL 查询）\n\n**参数:**\n- `query` - 搜索关键词或完整 Elasticsearch DSL JSON\n- `time_range` - 时间范围，默认 \"now-1h\"\n- `size` - 返回数量，默认 20\n- `index_pattern` - 索引模式，默认 \"logstash-*\"\n- `fields` - 返回字段列表\n\n**示例 1: 关键词搜索**\n```json\n{\n  \"query\": \"user_id\",\n  \"time_range\": \"now-30m\",\n  \"size\": 10\n}\n```\n\n**示例 2: DSL 查询**\n```json\n{\n  \"query\": \"{\\\"query\\\":{\\\"bool\\\":{\\\"must\\\":[{\\\"match\\\":{\\\"kubernetes.container_name\\\":\\\"api-server\\\"}}]}}}\",\n  \"time_range\": \"now-1h\",\n  \"size\": 50\n}\n```\n\n---\n\n### 3. `kibana_aggregate_logs`\n聚合统计日志\n\n**参数:**\n- `aggregation_type` - 聚合类型: \"by_service\" | \"by_time\" | \"custom\"\n- `time_range` - 时间范围，默认 \"now-1h\"\n- `filter` - 可选过滤条件（DSL JSON）\n- `custom_aggregation` - 自定义聚合（仅 custom 类型）\n- `index_pattern` - 索引模式\n\n**示例 1: 按服务统计**\n```json\n{\n  \"aggregation_type\": \"by_service\",\n  \"time_range\": \"now-24h\"\n}\n```\n\n**示例 2: 按时间统计**\n```json\n{\n  \"aggregation_type\": \"by_time\",\n  \"time_range\": \"now-6h\"\n}\n```\n\n---\n\n### 4. `kibana_get_latest_logs`\n快速获取最新日志\n\n**参数:**\n- `service` - 服务名称（可选）\n- `size` - 返回数量，默认 10\n- `i…","publisher":{"name":"Development Team","url":null},"homepage":null,"repository":null,"version":"0.0.2","license":"MIT","protocols":["mcp"],"tags":["elasticsearch","kibana","logs","mcp","server"],"pricing":null,"endpoints":[{"url":"pypi:kibana-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"kibana-mcp-server","registry":"pypi","observedAt":"2026-11-03T10:25:14.086Z","publishedAt":"2026-03-06T07:00:15.070104Z","latestVersion":"0.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"kibana-mcp-server","url":"https://pypi.org/project/kibana-mcp-server/","firstSeenAt":"2026-09-09T22:23:23.415Z","fetchedAt":"2026-11-03T10:24:05.294Z","normalizedAt":"2026-11-03T10:24:05.294Z"}]},"firstSeenAt":"2026-09-09T22:23:23.415Z","updatedAt":"2026-11-03T10:25:14.086Z"}