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:

list_groups : enumera los grupos de registros de CloudWatch disponibles
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.