Servidor MCP de Datadog

Servidor MCP para la API de Datadog, que permite la gestión de incidentes y más.

Características

• Herramientas de observación : proporciona un mecanismo para aprovechar las funciones clave de monitoreo de Datadog, como incidentes, monitores, registros, paneles y métricas, a través del servidor MCP.
• Diseño extensible : diseñado para integrarse fácilmente con API adicionales de Datadog, lo que permite una expansión de funciones futuras sin inconvenientes.

Herramientas

1. list_incidents
   • Recupere una lista de incidentes de Datadog.
   • Entradas :
     • filter (cadena opcional): parámetros de filtro para incidentes (por ejemplo, estado, prioridad).
     • pagination (objeto opcional): Detalles de paginación como tamaño/desplazamiento de la página.
   • Devuelve : Matriz de incidentes de Datadog y metadatos asociados.
2. get_incident
   • Recupere información detallada sobre un incidente específico de Datadog.
   • Entradas :
     • incident_id (cadena): ID del incidente del que se obtendrán detalles.
   • Devuelve : Información detallada del incidente (título, estado, marcas de tiempo, etc.).
3. get_monitors
   • Obtener el estado de los monitores Datadog.
   • Entradas :
     • groupStates (matriz opcional): Estados para filtrar (por ejemplo, alerta, advertir, sin datos, ok).
     • name (cadena opcional): filtrar por nombre.
     • tags (matriz opcional): filtrar por etiquetas.
   • Devuelve : Monitorea datos y un resumen de sus estados.
4. get_logs
   • Busque y recupere registros de Datadog.
   • Entradas :
     • query (cadena): Datadog registra la cadena de consulta.
     • from (número): Hora de inicio en segundos de época.
     • to (número): Hora de finalización en segundos de época.
     • limit (número opcional): número máximo de registros a devolver (predeterminado 100).
   • Devuelve : Matriz de registros coincidentes.
5. list_dashboards
   • Obtenga una lista de paneles de Datadog.
   • Entradas :
     • name (cadena opcional): filtra los paneles por nombre.
     • tags (matriz opcional): filtra los paneles por etiquetas.
   • Devuelve : Matriz de paneles con referencias URL.
6. get_dashboard
   • Recupere un panel específico de Datadog.
   • Entradas :
     • dashboard_id (cadena): ID del panel a recuperar.
   • Devuelve : Detalles del panel, incluido título, widgets, etc.
7. get_metrics
   • Recupere datos de métricas de Datadog.
   • Entradas :
     • query (cadena): cadena de consulta de métricas.
     • from (número): Hora de inicio en segundos de época.
     • to (número): Hora de finalización en segundos de época.
   • Devuelve : datos métricos para el período de tiempo consultado.
8. list_traces
   • Recupere una lista de seguimientos de APM de Datadog.
   • Entradas :
     • query (cadena): cadena de consulta de seguimiento de Datadog APM.
     • from (número): Hora de inicio en segundos de época.
     • to (número): Hora de finalización en segundos de época.
     • limit (número opcional): número máximo de seguimientos a devolver (predeterminado 100).
     • sort (cadena opcional): orden de clasificación de los seguimientos (el valor predeterminado es '-timestamp').
     • service (cadena opcional): filtrar por nombre de servicio.
     • operation (cadena opcional): filtrar por nombre de operación.
   • Devuelve : Matriz de seguimientos coincidentes de Datadog APM.
9. list_hosts
   • Obtenga la lista de hosts de Datadog.
   • Entradas :
     • filter (cadena opcional): cadena de filtro para los resultados de búsqueda.
     • sort_field (cadena opcional): Campo para ordenar los hosts.
     • sort_dir (cadena opcional): Dirección de ordenación (asc/desc).
     • start (número opcional): Desplazamiento inicial para la paginación.
     • count (número opcional): número máximo de hosts a devolver (máximo: 1000).
     • from (número opcional): busca hosts desde esta marca de tiempo de UNIX.
     • include_muted_hosts_data (booleano opcional): incluye el estado y la expiración de los hosts silenciados.
     • include_hosts_metadata (booleano opcional): incluye metadatos del host (versión, plataforma, etc.).
   • Devuelve : Matriz de hosts con detalles que incluyen nombre, ID, alias, aplicaciones, estado de silencio y más.
10. get_active_hosts_count

• Obtenga el número total de hosts activos en Datadog.
• Entradas :
  • from (número opcional): Número de segundos a partir del cual desea obtener el número total de hosts activos (el valor predeterminado es 2 h).
• Devuelve : recuento del total de hosts activos y activos.

11. mute_host

• Silenciar un host en Datadog.
• Entradas :
  • hostname (cadena): el nombre del host que se silenciará.
  • message (cadena opcional): Mensaje a asociar con el silenciamiento de este host.
  • end (número opcional): marca de tiempo POSIX que indica cuándo debe finalizar el silencio.
  • override (booleano opcional): si es verdadero y el host ya está silenciado, reemplaza la hora de finalización existente.
• Devuelve : Estado de éxito y mensaje de confirmación.

12. unmute_host

• Activar el silencio de un host en Datadog.
• Entradas :
  • hostname (cadena): el nombre del host cuyo sonido se va a anular.
• Devuelve : Estado de éxito y mensaje de confirmación.

13. list_downtimes

• Enumere los tiempos de inactividad programados de Datadog.
• Entradas :
  • currentOnly (booleano opcional): devuelve solo los tiempos de inactividad actualmente activos cuando es verdadero.
  • monitorId (número opcional): filtrar por ID de monitor.
• Devoluciones : Matriz de tiempos de inactividad programados con detalles que incluyen alcance, información del monitor y cronograma.

14. schedule_downtime

• Programe un tiempo de inactividad en Datadog.
• Entradas :
  • scope (cadena): Ámbito al que se aplicará el tiempo de inactividad (por ejemplo, 'host:my-host').
  • start (número opcional): marca de tiempo de UNIX para el inicio del tiempo de inactividad.
  • end (número opcional): marca de tiempo de UNIX para el final del tiempo de inactividad.
  • message (cadena opcional): un mensaje para incluir con el tiempo de inactividad.
  • timezone (cadena opcional): la zona horaria para el tiempo de inactividad (por ejemplo, 'UTC', 'América/Nueva_York').
  • monitorId (número opcional): el ID del monitor a silenciar.
  • monitorTags (matriz opcional): una lista de etiquetas de monitor para filtrar.
  • recurrence (objeto opcional): configuración de recurrencia para el tiempo de inactividad.
    • type (cadena): Tipo de recurrencia ('días', 'semanas', 'meses', 'años').
    • period (número): con qué frecuencia repetir (debe ser >= 1).
    • weekDays (matriz opcional): días de la semana para la recurrencia semanal.
    • until (número opcional): marca de tiempo UNIX para cuando finaliza la recurrencia.
• Devoluciones : Detalles del tiempo de inactividad programado, incluida la identificación y el estado activo.

15. cancel_downtime

• Cancelar un tiempo de inactividad programado en Datadog.
• Entradas :
  • downtimeId (número): el ID del tiempo de inactividad que se cancelará.
• Devoluciones : Confirmación de cancelación del tiempo de inactividad.

Configuración

Credenciales de Datadog

Necesita credenciales de API de Datadog válidas para usar este servidor MCP:

• DATADOG_API_KEY : Su clave API de Datadog
• DATADOG_APP_KEY : Su clave de aplicación Datadog
• DATADOG_SITE (opcional): El sitio de Datadog (por ejemplo datadoghq.eu )

Exportelos a su entorno antes de ejecutar el servidor:

Instalación

Instalación mediante herrería

Para instalar Datadog MCP Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json

O especifique a través de npx :

Depuración

Dado que los servidores MCP se comunican mediante E/S estándar, la depuración a veces puede ser complicada. Recomendamos usar el Inspector MCP . Puede ejecutar el inspector con:

El inspector le proporcionará una URL que podrá abrir en su navegador para ver registros y enviar solicitudes manualmente.

Contribuyendo

¡Agradecemos sus contribuciones! Si tiene alguna sugerencia, informe de errores o propuesta de mejora, no dude en abrir un problema o una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la Licencia Apache, Versión 2.0 .