honeycomb-mcp-server

🚀 Honeycomb MCP 服务器

Honeycomb MCP 服务器是一款中间件解决方案，用于与 Honeycomb 平台进行交互。它提供了一系列 API 端点，可帮助用户创建、查询和管理 Honeycomb 数据集，极大地提升了数据处理和管理的效率。

🚀 快速开始

Honeycomb MCP 服务器的安装与配置十分简便，以下是具体步骤：

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 文件获取详细信息。