Honeycomb MCP Server

基本能力

产品定位

Honeycomb MCP Server 是一个专为 Honeycomb 可观测性数据设计的 MCP 服务器，旨在通过 LLM 直接分析和查询数据集。

核心功能

• 查询多个环境中的 Honeycomb 数据集
• 支持多种计算类型（COUNT, AVG, P95 等）的分析查询
• 支持分组和过滤
• 时间序列分析
• 监控 SLO 状态（仅限企业版）
• 分析列和数据模式
• 查看和分析触发器
• 访问数据集元数据和模式信息
• 通过 TTL 缓存优化非查询 API 调用的性能

适用场景

• 跨环境分析 Honeycomb 数据集
• 监控 SLO 状态
• 分析 API 调用性能
• 查看异常和错误分布
• 生成 OpenTelemetry 仪表化指南

工具列表

• list_datasets: 列出环境中的所有数据集
• get_columns: 获取数据集的列信息
• run_query: 运行分析查询
• analyze_columns: 分析数据集中的特定列
• list_slos: 列出数据集的所有 SLO
• get_slo: 获取详细的 SLO 信息
• list_triggers: 列出数据集的所有触发器
• get_trigger: 获取详细的触发器信息
• get_trace_link: 生成指向 Honeycomb UI 中特定跟踪的深层链接
• get_instrumentation_help: 提供 OpenTelemetry 仪表化指南

常见问题解答

• Q: 如何配置多个环境？ A: 在 MCP 配置的 env 块中设置 HONEYCOMB_ENV_<ENV>_API_KEY 环境变量。
• Q: EU 客户需要特殊配置吗？ A: 是的，需要设置 HONEYCOMB_API_ENDPOINT 为 https://api.eu1.honeycomb.io/。
• Q: 如何启用缓存？ A: 默认启用，可通过 HONEYCOMB_CACHE_ENABLED 环境变量配置。

使用教程

使用依赖

• Node.js 16+
• Honeycomb API 密钥（具有查询和分析权限）

安装教程

pnpm install
pnpm run build

调试方式

1. 确保构建产物位于 /build 文件夹
2. 在 MCP 配置中正确设置 command 和 args
3. 确保环境变量（如 HONEYCOMB_API_KEY）已正确设置
4. 运行客户端（如 Claude Desktop）并尝试查询数据集

开发

pnpm install
pnpm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。