Honeycomb MCP Server

基本能力

产品定位

Honeycomb MCP Server 是一个中间件，旨在通过 MCP 协议将 Claude AI 与 Honeycomb 监控平台集成，实现自动化监控和数据分析。

核心功能

1. 数据集管理：列出、获取和创建 Honeycomb 数据集。
2. 查询管理：创建、获取和执行查询，并获取查询结果。
3. 看板管理：列出和获取 Honeycomb 看板信息。
4. SLOs 和触发器管理：创建和管理服务级别目标（SLOs）和触发器。
5. 事件管理：创建和查询事件数据。

适用场景

1. 自动化监控：自动创建和管理监控查询和警报。
2. 事件调查：快速查询和分析生产环境中的事件数据。
3. SLO 管理：自动化创建和管理服务级别目标。
4. 数据分析：执行复杂的数据分析查询并可视化结果。

工具列表

1. honeycomb_auth：验证 Honeycomb API 密钥。
2. honeycomb_datasets_list：列出所有可用数据集。
3. honeycomb_dataset_get：获取特定数据集的详细信息。
4. honeycomb_query_create：创建新查询。
5. honeycomb_query_get：获取查询信息。
6. honeycomb_query_result_create：执行查询并返回结果。
7. honeycomb_query_result_get：获取查询结果。
8. honeycomb_boards_list：列出所有看板。
9. honeycomb_board_get：获取看板详细信息。

常见问题解答

1. 认证问题：确保 HONEYCOMB_API_KEY 环境变量设置正确。
2. 数据集未找到：检查数据集 slug 是否正确。
3. 查询执行问题：验证查询参数格式是否正确。
4. 速率限制：Honeycomb API 有速率限制，需合理控制请求频率。

使用教程

使用依赖

• Node.js 18 或更高版本
• Honeycomb API 密钥

安装教程

# 全局安装
npm install -g @kajirita2002/honeycomb-mcp-server

# 或直接使用 npx
npx @kajirita2002/honeycomb-mcp-server

设置环境变量

export HONEYCOMB_API_KEY="your_honeycomb_api_key"

MCP 配置示例

在 mcp_config.json 文件中添加以下配置：

"honeycomb": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/honeycomb-mcp-server"],
  "env": {
    "HONEYCOMB_API_KEY": "your_honeycomb_api_key"
  }
}

启动服务器

npm start

调试方式

1. 检查环境变量是否设置正确。
2. 使用 honeycomb_auth 工具验证 API 密钥是否有效。
3. 执行简单的查询操作，如 honeycomb_datasets_list，确认服务器正常运行。

许可证

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