Honeycomb MCP 服务器

简介

Honeycomb MCP（中间件处理进程）服务器是一个用于与 Honeycomb 平台交互的中间件解决方案。它提供了一系列 API 端点，使您能够创建、查询和管理 Honeycomb 数据集。

功能特性

• 事件摄取：支持批量或单个事件的高效上传。
• 数据集管理：轻松创建、更新和删除数据集。
• 查询功能：通过灵活的查询 API 进行数据分析，包括过滤、分组和聚合操作。
• 错误处理：详细的错误信息帮助快速定位问题。

快速入门

安装与配置

1. 克隆仓库：

   git clone https://github.com/your-username/honeycomb-mcp-server.git
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   node index.js
   

核心 API 端点

创建数据集

请求示例：

POST /api/datasets
{
  "name": "Application Monitoring",
  "description": "Monitoring for our production application"
}

响应示例：

{
  "dataset": {
    "id": "60a3c5d94b16f00079b4c8d2",
    "name": "Application Monitoring",
    "description": "Monitoring for our production application",
    "created_at": "2025-03-25T14:30:00Z"
  }
}

查询数据

请求示例：

GET /api/datasets/{datasetId}/events?from=2025-03-25T14%3A30%3A00Z&to=2025-03-26T14%3A30%3A00Z

响应示例：

{
  "events": [
    {
      "id": "1",
      "data": {
        "service": "api-server",
        "message": "User login successful",
        "duration_ms": 45,
        "status_code": 200,
        "endpoint": "/api/login",
        "timestamp": "2025-03-25T14:30:00Z"
      }
    }
  ]
}

技术细节

数据模型

所有事件数据必须符合以下结构：

{
  "id": string,
  "data": {
    // 自定义字段
  },
  "timestamp": string // ISO 格式时间字符串
}

查询语法

支持的查询操作符包括 =, !=, >, <, >=, <=, IN, NOT IN。您还可以组合多个条件使用逻辑运算符 AND 和 OR。

错误处理

当出现错误时，服务器会返回统一格式的错误信息：

{
  "error": {
    "message": "Detailed error description",
    "code": "ERROR_CODE"
  }
}

常见错误代码

• BAD_REQUEST: 请求参数无效。
• NOT_FOUND: 资源不存在。
• INTERNAL_SERVER_ERROR: 服务器内部错误。

贡献指南

开发流程

1. 克隆仓库：

   git clone https://github.com/your-username/honeycomb-mcp-server.git
   

2. 安装依赖：

   npm install
   

3. 启动开发环境：

   npm run dev
   

代码规范

• 遵循 ESLint 代码规范。
• 提供详细的提交信息，包括问题描述和解决方案。

许可证

此项目遵循 MIT 许可证。请查看 LICENSE 文件获取详细信息。