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

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

Argumentos de la línea de comandos

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

Nota: El argumento del sitio no necesita https:// - se agregará automáticamente.

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)"
      ]
    }
  }
}

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

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

datadog mcp

Integrations