Honeycomb MCP

Un servidor Model Context Protocol per interactuar amb dades d'observabilitat de Honeycomb. Aquest servidor permet a LLM com Claude analitzar i consultar directament els vostres conjunts de dades Honeycomb a través de múltiples entorns.

Requisits

• Node.js 18+
• Clau d'API de Honeycomb amb permisos complets:
  • Accés a consultes d'anàlisi
  • Accés de lectura a SLOs i Triggers
  • Accés a nivell d'entorn per a operacions de conjunts de dades

Honeycomb MCP és efectivament una interfície alternativa completa a Honeycomb, i per tant necessiteu permisos amplis per a l'API.

Només per a Honeycomb Enterprise

Actualment, només està disponible per a clients Enterprise de Honeycomb.

Com funciona

Avui dia, es tracta d'un sol procés de servidor que heu de executar al vostre propi ordinador. No està autenticat. Tota la informació utilitza STDIO entre el vostre client i el servidor.

Instal·lació

pnpm install
pnpm run build

L'arxiu de construcció es desa a la carpeta /build.

Configuració

Per utilitzar aquest servidor MCP, heu de proporcionar les claus d'API de Honeycomb a través de variables d'entorn en la vostra configuració MCP.

{
    "mcpServers": {
      "honeycomb": {
        "command": "node",
        "args": [
          "/fully/qualified/path/to/honeycomb-mcp/build/index.mjs"
        ],
        "env": {
          "HONEYCOMB_API_KEY": "your_api_key"
        }
      }
    }
}

Per a múltiples entorns:

{
    "mcpServers": {
      "honeycomb": {
        "command": "node",
        "args": [
          "/fully/qualified/path/to/honeycomb-mcp/build/index.mjs"
        ],
        "env": {
          "HONEYCOMB_ENV_PROD_API_KEY": "your_prod_api_key",
          "HONEYCOMB_ENV_STAGING_API_KEY": "your_staging_api_key"
        }
      }
    }
}

Important: Aquestes variables d'entorn han d'estar configurades al bloc env de la vostra configuració MCP.

Configuració EU

Els clients EU també han de configurar HONEYCOMB_API_ENDPOINT, ja que el MCP per defecte apunta a la instància no EU.

# Optional custom API endpoint (defaults to https://api.honeycomb.io)
HONEYCOMB_API_ENDPOINT=https://api.eu1.honeycomb.io/

Configuració de caché

El servidor MCP implementa caché per a totes les crides d'API Honeycomb que no són de consulta per millorar el rendiment i reduir l'ús de l'API. La caché es pot configurar amb les variables d'entorn següents:

# Enable/disable caching (default: true)
HONEYCOMB_CACHE_ENABLED=true

# Default TTL in seconds (default: 300)
HONEYCOMB_CACHE_DEFAULT_TTL=300

# Resource-specific TTL values in seconds (defaults shown)
HONEYCOMB_CACHE_DATASET_TTL=900    # 15 minutes
HONEYCOMB_CACHE_COLUMN_TTL=900     # 15 minutes
HONEYCOMB_CACHE_BOARD_TTL=900      # 15 minutes
HONEYCOMB_CACHE_SLO_TTL=900        # 15 minutes
HONEYCOMB_CACHE_TRIGGER_TTL=900    # 15 minutes
HONEYCOMB_CACHE_MARKER_TTL=900     # 15 minutes
HONEYCOMB_CACHE_RECIPIENT_TTL=900  # 15 minutes
HONEYCOMB_CACHE_AUTH_TTL=3600      # 1 hour

# Maximum cache size (items per resource type)
HONEYCOMB_CACHE_MAX_SIZE=1000

Compatibilitat amb clients

Honeycomb MCP ha estat provat amb els següents clients:

• Claude Desktop
• Claude Code
• Cursor
• Windsurf
• Goose

Probablement funcionarà amb altres clients.

Funcionalitats

• Consultar conjunts de dades Honeycomb a través de múltiples entorns
• Executar consultes d'anàlisi amb suport per a:
  • Tipus de càlcul múltiples (COUNT, AVG, P95, etc.)
  • Desglossaments i filtres
  • Anàlisi basada en el temps
• Monitoritzar SLOs i el seu estat (només Enterprise)
• Analitzar columnes i patrons de dades
• Veure i analitzar Triggers
• Accedir a metadades i informació de l'esquema del conjunt de dades
• Rendiment optimitzat amb caché basat en TTL per a totes les crides d'API que no són de consulta

Recursos

Accediu als conjunts de dades Honeycomb utilitzant URIs en el format:

Per exemple:

• honeycomb://production/api-requests
• honeycomb://staging/backend-services

La resposta del recurs inclou:

• Nom del conjunt de dades
• Informació de columnes (nom, tipus, descripció)
• Detalls de l'esquema

Eines

• list_datasets: Llistar tots els conjunts de dades en un entorn

  { "environment": "production" }
  

• list_datasets (amb opcions de paginació)

  { "environment": "production", "page": 1, "page_size": 20 }
  

• list_datasets (amb filtres)

  { "environment": "production", "name": "api" }
  

• list_datasets (amb desglossaments)

  { "environment": "production", "expand": ["boards"] }
  

• list_datasets (amb filtres i desglossaments)

  { "environment": "production", "name": "api", "expand": ["boards"] }
  

• get_dataset: Obtenir informació d'un conjunt de dades específic

  { "environment": "production", "name": "api-requests" }
  

• list_boards: Llistar tots els taulells d'un conjunt de dades

  { "environment": "production", "dataset": "api-requests" }
  

• list_boards