Honeycomb Mcp Server

监控官方认证本地 TypeScript

🚀 Honeycomb MCP 服务器

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

🚀 快速开始

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

克隆仓库：

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

安装依赖：
```
npm install
```
启动服务：
```
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	服务器内部错误。

贡献指南

开发流程