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"
  }
}

常見錯誤代碼

貢獻指南

開發流程

1. 克隆倉庫：

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

2. 安裝依賴：

   npm install
   

3. 啟動開發環境：

   npm run dev
   

代碼規範

• 遵循 ESLint 代碼規範。
• 提供詳細的提交信息，包括問題描述和解決方案。

📄 許可證

此項目遵循 MIT 許可證。請查看 LICENSE 文件獲取詳細信息。