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: Currents

Prerrequisitos

Node.js (versión 16 o superior)
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

Clonar este repositorio
Instalar dependencias:
```
npm install
```
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:

Su clave API y clave de aplicación son correctas
Las claves tienen los permisos necesarios para acceder a los recursos solicitados
Su cuenta tiene acceso a los datos solicitados
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)

datadog mcp