Servidor MCP Honeycomb
Lea esto en
Descripción general
Este servidor es una interfaz que utiliza el Protocolo de contexto de modelo (MCP) para permitir que Claude AI interactúe con la API de Honeycomb .
Con este servidor MCP, Claude AI puede realizar operaciones como recuperar, crear y actualizar conjuntos de datos de Honeycomb, consultas, eventos, tableros, marcadores, SLO y activadores.
Acerca del repositorio
Este repositorio proporciona una implementación independiente del servidor Honeycomb MCP. Integra Claude AI con Honeycomb para optimizar los flujos de trabajo de observabilidad y monitorización.
Configuración
Prerrequisitos
Node.js 18 o superior
Clave API de Honeycomb
Instalación
Configuración de variables de entorno
Ejemplo de configuración de MCP
Si está utilizando este servidor MCP, agregue la siguiente configuración a su archivo mcp_config.json
:
Iniciando el servidor
Herramientas disponibles
Este servidor MCP proporciona las siguientes herramientas:
Autenticación
honeycomb_auth
Se autentica con la API de Honeycomb
Aporte:
apiKey
(cadena, opcional): clave de API de Honeycomb (si no se proporciona, utiliza una variable de entorno)
Gestión de conjuntos de datos
honeycomb_datasets_list
Enumera todos los conjuntos de datos disponibles
No se requieren parámetros de entrada
honeycomb_dataset_get
Obtiene información sobre un conjunto de datos específico
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datos
honeycomb_datasets_create
Crea un nuevo conjunto de datos
Aporte:
name
(cadena, obligatorio): nombre del conjunto de datosdescription
(cadena, opcional): Descripción del conjunto de datos
Gestión de columnas
honeycomb_columns_list
Enumera todas las columnas de un conjunto de datos
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datos
Gestión de consultas
honeycomb_query_create
Crea una nueva consulta para un conjunto de datos
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datosquery
(objeto, requerido): Configuración de la consulta
honeycomb_query_result_create
Ejecuta una consulta y devuelve los resultados.
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datosquery
(objeto, requerido): Configuración de la consulta
Gestión de eventos
honeycomb_event_create
Crea un nuevo evento en un conjunto de datos
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datosdata
(objeto, requerido): Datos del evento
Junta Directiva
honeycomb_boards_list
Enumera todos los tableros
No se requieren parámetros de entrada
honeycomb_board_get
Obtiene información sobre un tablero específico
Aporte:
boardId
(cadena, obligatoria): ID del tablero
honeycomb_board_create
Crea un nuevo tablero
Aporte:
name
(cadena, obligatorio): Nombre del tablerodescription
(cadena, opcional): Descripción del tableroquery_ids
(matriz de cadenas, opcional): ID de consulta que se incluirán en el tablero
honeycomb_board_update
Actualiza un tablero existente
Aporte:
boardId
(cadena, obligatoria): ID del tablero a actualizarname
(cadena, opcional): Nuevo nombre para el tablerodescription
(cadena, opcional): Nueva descripción para el tableroquery_ids
(matriz de cadenas, opcional): nuevos ID de consulta para incluir en el tablero
Gestión de marcadores
honeycomb_markers_list
Enumera todos los marcadores de un conjunto de datos
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datos
honeycomb_marker_create
Crea un nuevo marcador
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datosmessage
(cadena, obligatorio): Mensaje para el marcadortype
(cadena, obligatorio): Tipo del marcadorstart_time
(cadena, obligatoria): hora de inicio del marcadorend_time
(cadena, opcional): hora de finalización del marcadorurl
(cadena, opcional): URL asociada con el marcador
Aporte:
datasetSlug
(cadena, obligatoria): Slug del conjunto de datosmarkerId
(cadena, obligatoria): ID del marcador a eliminar
Ejemplo de uso
A continuación se muestra un ejemplo de Claude utilizando este servidor MCP para crear un nuevo conjunto de datos Honeycomb y agregar un evento:
Patrones de integración comunes
Automatización de la observabilidad
[User] Claude, please help me set up a new SLO for API response times. [Claude] I can help with that. Let me create an SLO to track API response times. I'll use honeycomb_slo_create with these parameters: { "datasetSlug": "production-api", "name": "API Response Time SLO", "description": "Tracks response time for critical API endpoints", "sli": { "alias": "Response Time < 300ms", "conditions": { "column": "duration_ms", "operator": "<", "value": 300 } }, "time_period_days": 30, "target_per_million": 995000 }Investigación de incidentes
[User] We're seeing elevated error rates in production. Can you help investigate? [Claude] I'll help investigate the elevated error rates. Let me query the recent error data. First, I'll use honeycomb_query_result_create: { "datasetSlug": "production", "query": { "calculations": [ { "op": "COUNT" } ], "filters": [ { "column": "status_code", "operator": ">=", "value": 500 } ], "breakdowns": ["service", "endpoint"], "time_range": 3600, "granularity": 60 } }
Creando el conjunto de datos "Monitoreo de aplicaciones" con la descripción "Monitoreo para nuestra aplicación de producción"...
[Claude usa honeycomb_datasets_create]
¡El conjunto de datos se ha creado correctamente! Ahora podemos añadirle eventos.
¿Quieres que cree un evento de muestra en el conjunto de datos para probarlo?
[Usuario] Sí, agregue un evento de muestra.
[Claude] Agregaré un evento de muestra al conjunto de datos "Monitoreo de aplicaciones".
[Claude usa honeycomb_event_create]
¡Éxito! He añadido un evento de ejemplo a tu conjunto de datos "Monitoreo de aplicaciones" con los siguientes datos: { "service": "api-server", "message": "Inicio de sesión exitoso", "duration_ms": 45, "status_code": 200, "endpoint": "/api/login", "timestamp": "2025-03-25T14:30:00Z" }
Este evento representa una operación de inicio de sesión de usuario exitosa que tardó 45 ms en completarse.
Ahora puede ver este evento en su panel de Honeycomb y comenzar a crear consultas para analizar sus datos.
Códigos de error comunes
AUTH_ERROR
: Error de autenticación. Verifique su clave API.NOT_FOUND
: No se encontró el recurso solicitado.INVALID_PARAMETER
: Uno o más parámetros no son válidos.RATE_LIMIT
: Se ha alcanzado el límite de velocidad de la API de Honeycomb.SERVER_ERROR
: Ocurrió un error interno del servidor.
Consejos para la solución de problemas
Problemas de autenticación
Asegúrese de que su
HONEYCOMB_API_KEY
esté configurada correctamenteVerifique que la clave API tenga los permisos adecuados
Conjunto de datos no encontrado
Confirme que el slug del conjunto de datos sea correcto (verifique si hay errores tipográficos)
Asegúrese de que el conjunto de datos exista en su cuenta de Honeycomb
Problemas de ejecución de consultas
Validar que los parámetros de consulta estén formateados correctamente
Compruebe que los nombres de las columnas en las consultas coincidan con los de su conjunto de datos
Contribuyendo
¡Agradecemos las contribuciones al servidor Honeycomb MCP! Puedes contribuir de la siguiente manera:
Configuración de desarrollo
Bifurcar el repositorio
Clona tu bifurcación
git clone https://github.com/your-username/honeycomb-mcp-server.gitInstalar dependencias
npm installRealiza tus cambios
Ejecutar la compilación
npm run buildPruebe sus cambios localmente
Proceso de solicitud de extracción
Crear una rama de características
git checkout -b feat-your-feature-nameConfirme sus cambios siguiendo el formato de confirmaciones convencionales
git commit -m "feat: add new feature"Empuja hacia tu tenedor
git push origin feat-your-feature-nameAbrir una solicitud de extracción
Estándares de codificación
Utilice TypeScript para todo el código nuevo
Seguir el estilo de código existente
Agregar comentarios para las API públicas
Escribir pruebas para nuevas funcionalidades
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
servidor honeycomb-mcp
- Descripción general
- Acerca del repositorio
- Configuración
- Herramientas disponibles
- Ejemplo de uso
- Contribuyendo
- Licencia
Related Resources
Related MCP Servers
- MIT License
- MIT License
- PythonMIT License