蜂窝微通道板

用于与 Honeycomb 可观测性数据交互的模型上下文协议服务器。该服务器使像 Claude 这样的法学硕士 (LLM) 能够跨多个环境直接分析和查询 Honeycomb 数据集。

仅限 Honeycomb Enterprise

目前，该功能仅适用于 Honeycomb Enterprise 客户。

工作原理

目前，这是一个单服务器进程**，您必须在自己的计算机上运行**。它无需身份验证。所有信息都使用客户端和服务器之间的 STDIO 进行传输。

安装

构建工件进入/build文件夹。

配置

要使用此 MCP 服务器，您需要通过 MCP 配置中的环境变量提供 Honeycomb API 密钥。

对于多种环境：

重要提示：这些环境变量必须在 MCP 配置的env块中设置。

欧盟配置

由于 MCP 默认为非欧盟实例，因此欧盟客户还必须设置HONEYCOMB_API_ENDPOINT配置。

缓存配置

MCP 服务器为所有非查询 Honeycomb API 调用实现了缓存，以提高性能并减少 API 使用率。您可以使用以下环境变量配置缓存：

客户端兼容性

Honeycomb MCP 已通过以下客户端测试：

• 克劳德桌面
• 克劳德·科德
• 光标
• 风帆冲浪
• 鹅

它可能会与其他客户端合作。

特征

• 跨多个环境查询 Honeycomb 数据集
• 运行分析查询并支持以下功能：
  • 多种计算类型（COUNT、AVG、P95 等）
  • 细分和过滤器
  • 基于时间的分析
• 监控 SLO 及其状态（仅限企业）
• 分析列和数据模式
• 查看和分析触发器
• 访问数据集元数据和架构信息
• 通过基于 TTL 的缓存优化所有非查询 API 调用的性能

资源

使用以下格式的 URI 访问 Honeycomb 数据集： honeycomb://{environment}/{dataset}

例如：

• honeycomb://production/api-requests
• honeycomb://staging/backend-services

资源响应包括：

• 数据集名称
• 列信息（名称、类型、描述）
• 架构详细信息

工具

• list_datasets ：列出环境中的所有数据集
  { "environment": "production" }
• get_columns ：获取数据集的列信息
  { "environment": "production", "dataset": "api-requests" }
• run_query ：使用丰富的选项运行分析查询
  { "environment": "production", "dataset": "api-requests", "calculations": [ { "op": "COUNT" }, { "op": "P95", "column": "duration_ms" } ], "breakdowns": ["service.name"], "time_range": 3600 }
• analyze_columns ：通过运行统计查询并返回计算指标来分析数据集中的特定列。
• list_slos ：列出数据集的所有 SLO
  { "environment": "production", "dataset": "api-requests" }
• get_slo ：获取详细的 SLO 信息
  { "environment": "production", "dataset": "api-requests", "sloId": "abc123" }
• list_triggers ：列出数据集的所有触发器
  { "environment": "production", "dataset": "api-requests" }
• get_trigger ：获取详细的触发器信息
  { "environment": "production", "dataset": "api-requests", "triggerId": "xyz789" }
• get_trace_link ：生成指向 Honeycomb UI 中特定跟踪的深层链接
• get_instrumentation_help ：提供 OpenTelemetry 检测指导
  { "language": "python", "filepath": "app/services/payment_processor.py" }

Claude 的示例查询

向克劳德询问以下问题：

• “生产环境中有哪些可用的数据集？”
• “显示过去一小时内 API 服务的 P95 延迟”
• “按服务名称细分的错误率是多少？”
• “有哪些 SLO 接近超出预算？”
• “显示暂存环境中的所有活动触发器”
• “生产 API 数据集中有哪些可用的列？”

优化工具响应

所有工具响应都经过优化，以减少上下文窗口的使用，同时保留基本信息：

• 列出数据集：仅返回名称、slug 和描述
• 获取列：返回简化的列信息，重点关注名称、类型和描述
• 运行查询：
  • 包括实际结果和必要的元数据
  • 添加自动计算的汇总统计数据
  • 仅包含热图查询的系列数据
  • 省略详细的元数据、链接和执行细节
• 分析列：
  • 返回最高值、计数和关键统计数据
  • 在适当的时候自动计算数值指标
• SLO 信息：精简为关键状态指标和绩效指标
• 触发信息：重点关注触发状态、条件、通知对象

这种优化确保响应简洁而完整，从而允许 LLM 在上下文限制内处理更多数据。

run_query的查询规范

run_query工具支持全面的查询规范：

• 计算：要执行的操作数组
  • 支持的操作：COUNT、CONCURRENCY、COUNT_DISTINCT、HEATMAP、SUM、AVG、MAX、MIN、P001、P01、P05、P10、P25、P50、P75、P90、P95、P99、P999、RATE_AVG、RATE_SUM、RATE_MAX
  • 某些操作（例如 COUNT 和 CONCURRENCY）不需要列
  • 例如： {"op": "HEATMAP", "column": "duration_ms"}
• filters ：过滤条件数组
  • 支持的运算符：=、!=、>、>=、<、<=、starts-with、does-not-start-with、exists、does-not-exist、contains、does-not-contain、in、not-in
  • 例如： {"column": "error", "op": "=", "value": true}
• filter_combination ：“AND”或“OR”（默认为“AND”）
• breakdowns ：按列对结果进行分组的数组
  • 例如： ["service.name", "http.status_code"]
• orders ：指定如何对结果进行排序的数组
  • 必须引用细分或计算中的列
  • HEATMAP 操作不能用于订单
  • 例如： {"op": "COUNT", "order": "descending"}
• time_range ：相对时间范围（以秒为单位）（例如，过去一小时为 3600 秒）
  • 可以与 start_time 或 end_time 结合使用，但不能同时与两者结合使用
• start_time和end_time ：绝对时间范围的 UNIX 时间戳
• having ：根据计算值过滤结果
  • 例如： {"calculate_op": "COUNT", "op": ">", "value": 100}

示例查询

以下是一些真实示例查询：

查找缓慢的 API 调用

DB 调用分布（上周）

按异常和调用者统计的异常数量

发展

要求

• Node.js 16+
• 具有适当权限的 Honeycomb API 密钥：
  • 查询分析访问权限
  • SLO 和触发器的读取权限
  • 数据集操作的环境级别访问

执照

麻省理工学院