Honeycomb MCP Server

基本能力

产品定位

Honeycomb MCP Server 是一个用于集成 Claude AI 和 Honeycomb API 的中间件，旨在通过 AI 自动化提升可观测性和监控效率。

核心功能

1. 数据集管理：列出、获取和创建 Honeycomb 数据集。
2. 列管理：列出数据集中的列，支持按列名过滤。
3. 查询管理：创建、获取和执行查询，支持复杂查询配置。
4. 看板管理：列出和获取 Honeycomb 看板信息。
5. 认证：通过 API 密钥进行 Honeycomb API 认证。

适用场景

1. 可观测性自动化：自动设置 SLOs 和监控指标。
2. 事件调查：快速查询和分析生产环境中的异常事件。
3. 数据探索：通过自然语言交互探索 Honeycomb 数据集。

工具列表

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

常见问题解答

1. 认证问题：确保 HONEYCOMB_API_KEY 环境变量正确设置。
2. 数据集未找到：检查数据集 slug 是否正确。
3. 查询执行问题：验证查询参数格式是否正确。

使用教程

使用依赖

• 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. 使用 npm start 启动服务后，检查日志输出是否有错误信息。
3. 使用提供的工具进行测试，如 honeycomb_datasets_list 验证连接是否正常。

许可证

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