Datadog mcp

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

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)

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

View all tools

para rastreo y seguimiento

Related Resources

Reddit Discussion about this server

Related MCP Servers

PyTorch HUD MCP Server
izaitsevfb
-
security
F
license
-
quality
Provides access to PyTorch CI/CD analytics data including workflows, jobs, test runs, and log analysis through an MCP interface.
Last updated -
Python
SolarWinds Logs MCP Server
jakenuts
A
security
F
license
A
quality
An MCP server for searching and visualizing SolarWinds Observability logs, allowing users to query log data with filtering options and generate visual representations of log events over time.
Last updated -
2
15
TypeScript
System Resource Monitor MCP Server
abhinav7895
-
security
A
license
-
quality
Provides Claude with real-time system monitoring capabilities, including CPU, memory, disk, network, battery, and internet speed metrics.
Last updated -
TypeScript
MIT License
MCP System Info Server
allenbijo
-
security
A
license
-
quality
A lightweight server that provides real-time system information including CPU, memory, disk, and GPU statistics for monitoring and diagnostic purposes.
Last updated -
Python
MIT License

View all related MCP servers

datadog mcp