Servidor MCP de CloudWatch Logs

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas para acceder a los registros de AWS CloudWatch. Este servidor permite a los asistentes de IA listar grupos de registros y leer entradas de registros de AWS CloudWatch.

Herramientas disponibles

grupos de listas

Enumera los grupos de registros de CloudWatch disponibles.

Parámetros:

• prefix (opcional): prefijo del nombre del grupo de registros

• region (opcional): región de AWS

• accessKeyId (opcional): ID de clave de acceso de AWS

• secretAccessKey (opcional): clave de acceso secreta de AWS

• sessionToken (opcional): token de sesión de AWS

Devuelve: cadena JSON con la lista de grupos de registros, incluidos logGroupName , creationTime y storedBytes .

obtener_registros

Obtiene registros de CloudWatch de un grupo de registros específico.

Parámetros:

• logGroupName (obligatorio): el nombre del grupo de registros

• logStreamName (opcional): el nombre del flujo de registro

• startTime (opcional): Hora de inicio en formato ISO o tiempo relativo (por ejemplo, "5m", "1h", "1d")

• endTime (opcional): Hora de finalización en formato ISO

• filterPattern (opcional): Patrón de filtro para los registros

• region (opcional): región de AWS

• accessKeyId (opcional): ID de clave de acceso de AWS

• secretAccessKey (opcional): clave de acceso secreta de AWS

• sessionToken (opcional): token de sesión de AWS

Devuelve: cadena JSON con los eventos de registro, incluidos timestamp , message y logStreamName .

Related MCP server: CloudWatch MCP Server

Configuración

Credenciales de AWS

Asegúrese de tener configuradas las credenciales de AWS. Puede configurarlas mediante la CLI de AWS o configurando variables de entorno:

• AWS_ACCESS_KEY_ID

• AWS_SECRET_ACCESS_KEY

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "python3",
      "args": ["/path/to/cloudwatch-logs-mcp/main.py"],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Estibador

Si prefiere ejecutar el servidor en un contenedor Docker, puede configurar un Dockerfile y usar la siguiente configuración:

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/cloudwatch-logs"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      }
    }
  }
}

Detalles de implementación

Este servidor se creó con la clase FastMCP del SDK de MCP, que facilita la creación de servidores MCP. El servidor expone dos herramientas principales:

1. list_groups : enumera los grupos de registros de CloudWatch disponibles

2. get_logs : lee entradas de registro de grupos de registros específicos

Cada herramienta se implementa como una función asíncrona decorada con @mcp.tool() . El servidor utiliza la biblioteca boto3 para interactuar con la API de AWS CloudWatch Logs.

Licencia

Instituto Tecnológico de Massachusetts (MIT)