Servidor MCP de Datadog

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Datadog.

Características

• Monitoreo : acceda a los datos y configuraciones del monitor

• Paneles de control : recuperar y ver definiciones de paneles de control

• Métricas : consulta las métricas disponibles y sus metadatos

• Eventos : busca y recupera eventos dentro de períodos de tiempo

• Registros : Busque registros con opciones avanzadas de filtrado y clasificación

• Incidentes : Acceso a datos de gestión de incidentes

• Integración de API : Integración directa con las API v1 y v2 de Datadog

• Manejo integral de errores : mensajes de error claros para problemas de API y autenticación

• Puntos finales específicos del servicio : Compatibilidad con diferentes puntos finales para registros y métricas

Related MCP server: Ingero

Prerrequisitos

1. Node.js (versión 16 o superior)

2. Cuenta Datadog con:

   • Clave API: se encuentra en Configuración de la organización > Claves API

   • Clave de aplicación: se encuentra en Configuración de la organización > Claves de aplicación

Instalación

A través de npm (recomendado)

npm install -g datadog-mcp-server

De la fuente

1. Clonar este repositorio

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

Configuración

Puede configurar el servidor Datadog MCP utilizando variables de entorno o argumentos de línea de comandos.

Variables de entorno

Cree un archivo .env con sus credenciales de Datadog:

DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com
DD_METRICS_SITE=datadoghq.com

Nota : DD_LOGS_SITE y DD_METRICS_SITE son opcionales y tendrán como valor predeterminado el de DD_SITE si no se especifican.

Argumentos de la línea de comandos

Uso básico con configuración global del sitio:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

Uso avanzado con puntos finales específicos del servicio:

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.com --logsSite=logs.datadoghq.com --metricsSite=metrics.datadoghq.com

Nota: Los argumentos del sitio no necesitan https:// - se agregará automáticamente.

Puntos finales regionales

Las diferentes regiones de Datadog tienen diferentes puntos finales:

• EE. UU. (predeterminado): datadoghq.com

• UE: datadoghq.eu

• US3 (GovCloud): ddog-gov.com

• US5: us5.datadoghq.com

• AP1: ap1.datadoghq.com

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>(e.g us5.datadoghq.com)"
      ]
    }
  }
}

Para configuraciones más avanzadas con puntos finales separados para registros y métricas:

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>",
        "--logsSite",
        "<YOUR_LOGS_SITE>",
        "--metricsSite",
        "<YOUR_METRICS_SITE>"
      ]
    }
  }
}

Ubicaciones para el archivo de configuración de Claude Desktop:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Uso con MCP Inspector

Para utilizar con la herramienta Inspector MCP:

npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key

Herramientas disponibles

El servidor proporciona estas herramientas MCP:

• get-monitors : Obtener monitores con filtrado opcional

• get-monitor : obtiene detalles de un monitor específico por ID

• get-dashboards : Lista todos los paneles

• get-dashboard : Obtener un panel específico por ID

• get-metrics : lista de métricas disponibles

• get-metric-metadata : obtener metadatos para una métrica específica

• get-events : recupera eventos dentro de un rango de tiempo

• get-incidents : Lista de incidentes con filtrado opcional

• registros de búsqueda : registros de búsqueda con filtrado avanzado de consultas

• added-logs : Realiza análisis y agregaciones en datos de registro

Ejemplos

Ejemplo: Obtener monitores

{
  "method": "tools/call",
  "params": {
    "name": "get-monitors",
    "arguments": {
      "groupStates": ["alert", "warn"],
      "limit": 5
    }
  }
}

Ejemplo: Obtener un panel de control

{
  "method": "tools/call",
  "params": {
    "name": "get-dashboard",
    "arguments": {
      "dashboardId": "abc-def-123"
    }
  }
}

Ejemplo: Registros de búsqueda

{
  "method": "tools/call",
  "params": {
    "name": "search-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app status:error",
        "from": "now-15m",
        "to": "now"
      },
      "sort": "-timestamp",
      "limit": 20
    }
  }
}

Ejemplo: Registros agregados

{
  "method": "tools/call",
  "params": {
    "name": "aggregate-logs",
    "arguments": {
      "filter": {
        "query": "service:web-app",
        "from": "now-1h",
        "to": "now"
      },
      "compute": [
        {
          "aggregation": "count"
        }
      ],
      "groupBy": [
        {
          "facet": "status",
          "limit": 10,
          "sort": {
            "aggregation": "count",
            "order": "desc"
          }
        }
      ]
    }
  }
}

Ejemplo: Obtener incidentes

{
  "method": "tools/call",
  "params": {
    "name": "get-incidents",
    "arguments": {
      "includeArchived": false,
      "query": "state:active",
      "pageSize": 10
    }
  }
}

Solución de problemas

Si encuentra un error 403 Prohibido, verifique que:

1. Su clave API y clave de aplicación son correctas

2. Las claves tienen los permisos necesarios para acceder a los recursos solicitados

3. Su cuenta tiene acceso a los datos solicitados

4. Estás utilizando el punto final correcto para tu región (por ejemplo, datadoghq.eu para clientes de la UE)

Depuración

Si encuentra problemas, consulte los registros MCP de Claude Desktop:

# On macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# On Windows
Get-Content -Path "$env:APPDATA\Claude\Logs\mcp*.log" -Tail 20 -Wait

Problemas comunes:

• 403 Prohibido: Problema de autenticación con las claves API de Datadog

• Formato de clave API o clave de aplicación no válido: asegúrese de estar utilizando las cadenas de clave completas

• Errores de configuración del sitio: asegúrese de estar utilizando el dominio Datadog correcto

• Desajustes de puntos finales: verifique que los puntos finales específicos del servicio estén configurados correctamente si está utilizando dominios separados para registros y métricas

Licencia

Instituto Tecnológico de Massachusetts (MIT)