Kibana MCP

Kibana MCP服务器

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

该项目基于官方的Elastic Kibana API文档，并使用Elastic Stack 8.x中的OpenAPI YAML规范。有关详细信息，请参阅 Kibana API文件.

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

💡 配套项目： 要完成Elastic Stack集成，请将其与 Elasticsearch MCP服务器 用于直接的Elasticsearch数据操作。

______________________________________________________________________

🚀 安装

# Global installation (recommended)
npm install -g @tocharianou/mcp-server-kibana

# Or use directly with npx
npx @tocharianou/mcp-server-kibana

来源

git clone https://github.com/TocharianOU/mcp-server-kibana.git
cd mcp-server-kibana
npm install && npm run build

______________________________________________________________________

🎯 快速开始

Claude桌面集成（推荐）

添加到您的Claude Desktop配置文件中：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kibana": {
      "command": "npx",
      "args": ["@tocharianou/mcp-server-kibana"],
      "env": {
        "KIBANA_URL": "http://your-kibana-server:5601",
        "KIBANA_API_KEY": "your-api-key",
        "KIBANA_DEFAULT_SPACE": "default"
      }
    }
  }
}

直接CLI使用

# Using API Key (recommended)
KIBANA_URL=http://localhost:5601 \
KIBANA_API_KEY=your-api-key \
npx @tocharianou/mcp-server-kibana

# Using Basic Auth
KIBANA_URL=http://localhost:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
npx @tocharianou/mcp-server-kibana

# Using Cookie Auth
KIBANA_URL=http://localhost:5601 \
KIBANA_COOKIES="sid=xxx; security-session=yyy" \
npx @tocharianou/mcp-server-kibana

HTTP模式（远程访问）

MCP_TRANSPORT=http \
MCP_HTTP_PORT=3000 \
KIBANA_URL=http://localhost:5601 \
KIBANA_API_KEY=your-api-key \
npx @tocharianou/mcp-server-kibana

访问地址： http://localhost:3000/mcp\ 健康检查： http://localhost:3000/health

______________________________________________________________________

✨ 特性

核心能力

• 双重运输方式：Stdio（本地）和HTTP（远程访问）
• 多种身份验证方法：API密钥，基本身份验证，基于Cookie
• 多空间支持：企业级Kibana空间管理
• SSL/TLS支持：自定义CA证书配置
• 会话管理：HTTP模式的自动UUID生成
• 动态API发现：基于Kibana OpenAPI官方规范

保存对象管理

• 对所有Kibana保存的对象类型完成CRUD操作
• 支持分页的智能搜索
• 批量操作，实现高效的批量更新
• 具有乐观并发性的版本控制
• 对象关系的引用管理

______________________________________________________________________

🔧 配置

必需变量

身份验证（选择一种方法）

可选变量

______________________________________________________________________

🛠️ 可用工具

基础工具

• get_status -获取Kibana服务器状态
• execute_kb_api -执行自定义Kibana API请求
• get_available_spaces -列出可用的Kibana空间
• search_kibana_api_paths -搜索API端点
• list_all_kibana_api_paths -列出所有API终结点
• get_kibana_api_detail -获取API端点详细信息

保存对象工具

• vl_search_saved_objects -搜索已保存的对象（通用）
• vl_get_saved_object -获取单个保存的对象
• vl_create_saved_object -创建新的已保存对象
• vl_update_saved_object -更新单个保存的对象
• vl_bulk_update_saved_objects -批量更新操作
• vl_bulk_delete_saved_objects -批量删除操作

支持的对象类型： 仪表板、可视化、索引模式、搜索、配置、镜头、地图、标签、画布工作台、画布元素

分析工具（v0.6.0+）

• analyze_object_dependencies -分析已保存的对象依赖关系
• analyze_deletion_impact -删除前检查影响
• check_dashboard_health -仪表板健康检查
• scan_all_dashboards_health -批量健康扫描

______________________________________________________________________

📖 资源

______________________________________________________________________

💬 查询示例

基本操作

• “我的Kibana服务器的状态如何？”
• “列出所有可用的Kibana空间”
• “显示与仪表板相关的所有API终结点”

保存的对象

• “搜索所有仪表板”
• “查找标题中包含'nginx'的可视化效果”
• “创建一个名为“销售概述”的新仪表板”
• “更新仪表板‘my-dashboard-123’的描述”
• “按ID删除多个仪表板”

健康与分析

• “检查仪表板‘概述’的运行状况”
• “分析可视化'viz-123'的依赖关系”
• “扫描所有仪表板以查找健康问题”

______________________________________________________________________

🐛 故障排除

连接问题

• 验证Kibana URL是否可访问
• 检查身份验证凭据
• 对于SSL问题： NODE_TLS_REJECT_UNAUTHORIZED=0 （小心使用）

Claude桌面问题

• 配置更改后重新启动Claude Desktop
• 验证JSON配置语法
• 检查控制台日志是否有错误

常见错误

• “import：找不到命令”：更新到最新版本
• 认证失败：验证凭据和权限
• SSL错误：检查CA证书或禁用SSL验证

______________________________________________________________________

🔍 调试

使用MCP检查器进行调试：

npm run inspector

这提供了一个浏览器可访问的调试界面。

______________________________________________________________________

📦 包裹信息

• NPM: @tocharianou/mcp服务器kibana
• GitHub: TocharianOU/mcp服务器kibana
• Node.js: >= 18.0.0
• 许可证：Apache 2.0

______________________________________________________________________

🤝 贡献

该项目由社区维护。欢迎投稿和反馈！

请遵循 弹性社区行为准则 在所有通信中。

______________________________________________________________________

📄 许可证

Apache许可证2.0-请参阅 许可证 文件以获取详细信息。