Kajirita2002 Honeycomb MCP Server

🚀 蜂巢（Honeycomb）MCP 服務器文檔

蜂巢（Honeycomb）MCP（管理控制平面）服務器是與 Honeycomb 數據庫交互的接口。它支持創建、查詢和管理數據集，還具備詳細的錯誤處理和日誌記錄功能，能有效提升數據管理效率。

🚀 快速開始

創建事件

要向 Honeycomb 數據庫添加單個事件，請使用以下 API：

POST /api/v1/event
Content-Type: application/json

{
  "dataset": "string",
  "body": {
    "key": "value"
  }
}

您還可以批量上傳多個事件：

POST /api/v1/events
Content-Type: application/json

[
  {
    "dataset": "string",
    "body": {
      "key": "value"
    }
  },
  ...
]

創建數據集

要創建一個新數據集，您可以使用以下命令：

POST /api/v1/dataset
Content-Type: application/json

{
  "name": "string",
  "description": "string"
}

✨ 主要特性

• 事件創建：支持批量或單個事件的添加。
• 數據集管理：方便地創建、更新和刪除數據集。
• 查詢功能：強大的過濾器和計算功能，幫助您高效分析數據。
• 錯誤處理：統一的錯誤返回格式，便於調試和處理異常。

📦 安裝指南

文檔中未提及安裝相關內容，暫不提供安裝指南。

💻 使用示例

基礎用法

以下是向數據庫添加單個事件的示例：

POST /api/v1/event
Content-Type: application/json

{
  "dataset": "string",
  "body": {
    "key": "value"
  }
}

高級用法

以下是進行高級查詢的示例，支持分組和排序：

GET /api/v1/dataset/{datasetSlug}/advanced-query
Query Parameters:
- filter: 過濾條件
- groupBy: 分組字段
- orderBy: 排序字段
- limit: 結果數量限制

📚 詳細文檔

數據集管理

更新數據集

更新現有數據集的名稱或描述：

PUT /api/v1/dataset/{datasetSlug}
Content-Type: application/json

{
  "name": "string",
  "description": "string"
}

刪除數據集

刪除指定的數據集：

DELETE /api/v1/dataset/{datasetSlug}

查詢功能

基本查詢

獲取特定數據集的所有事件：

GET /api/v1/dataset/{datasetSlug}/events

您還可以添加過濾器和計算：

GET /api/v1/dataset/{datasetSlug}/query
Query Parameters:
- filter: 過濾條件，例如 `column=value`
- calculate: 計算操作，例如 `count(*)`

高級查詢

支持更多複雜的查詢選項，如分組和排序：

GET /api/v1/dataset/{datasetSlug}/advanced-query
Query Parameters:
- filter: 過濾條件
- groupBy: 分組字段
- orderBy: 排序字段
- limit: 結果數量限制

錯誤處理

錯誤格式

當發生錯誤時，服務器會返回以下結構：

{
  "error": {
    "message": "詳細錯誤描述",
    "code": "ERROR_CODE"
  }
}

常見錯誤代碼

故障排除

驗證 API 密鑰

確保您使用的 API 密鑰正確且具有適當的權限。

GET /api/v1/whoami

檢查數據集存在性

在進行查詢或更新操作之前，確認目標數據集已存在。

HEAD /api/v1/dataset/{datasetSlug}

🔧 技術細節

文檔中未提及具體的技術實現細節，暫不提供技術細節說明。

📄 許可證

Honeycomb MCP 服務器遵循 MIT 許可證。請參閱 LICENSE 文件以獲取詳細信息。

感謝您使用 Honeycomb MCP 服務器！如需進一步幫助，請隨時查看我們的 FAQ 或聯繫支持團隊。

貢獻指南

如何貢獻

歡迎社區成員為 Honeycomb MCP 服務器做出貢獻！您可以通過以下方式參與：

• 提交問題報告。
• 創建功能請求。
• 提交代碼修復或新功能。

開發流程

1. 克隆倉庫：

git clone https://github.com/honeycomb/mcp.git

2. 安裝依賴：

npm install

3. 啟動開發服務器：

npm run dev