Honeycomb MCP Server

🚀 Honeycomb MCP サーバー

Honeycomb MCP（ミドルウェア処理プロセス）サーバーは、Honeycomb プラットフォームとのやり取りを行うためのミドルウェアソリューションです。一連の API エンドポイントを提供し、Honeycomb データセットの作成、クエリ、管理を行うことができます。

🚀 クイックスタート

インストールと設定

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

✨ 主な機能

• イベント取り込み：バッチまたは単一のイベントを効率的にアップロードできます。
• データセット管理：データセットの作成、更新、削除を簡単に行えます。
• クエリ機能：柔軟なクエリ API を通じて、フィルタリング、グルーピング、集計操作を含むデータ分析を行えます。
• エラー処理：詳細なエラー情報を提供し、問題の迅速な特定を支援します。

🔧 技術詳細

データモデル

すべてのイベントデータは以下の構造に従う必要があります：

{
  "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 ファイルを参照してください。