alertmanager-mcp-server

Tabla de contenido

• Tabla de contenido
• 1. Introducción
• 2. Características
• 3. Inicio rápido
  • 3.1. Requisitos previos
  • 3.2. Instalación mediante Smithery
  • 3.3. Ejecución local
  • 3.4. Ejecución de Docker
• 4. Herramientas
• 5. Desarrollo
• 6. Licencia

1. Introducción

Prometheus Alertmanager MCP es un servidor de Protocolo de Contexto de Modelo (MCP) para Prometheus Alertmanager. Permite que los asistentes y herramientas de IA consulten y gestionen los recursos de Alertmanager de forma programática y segura.

2. Características

• [x] Consultar el estado de Alertmanager, alertas, silencios, receptores y grupos de alertas
• [x] Crear, actualizar y eliminar silencios
• [x] Crear nuevas alertas
• [x] Soporte de autenticación (autenticación básica a través de variables de entorno)
• [x] Compatibilidad con contenedores Docker

3. Inicio rápido

3.1. Requisitos previos

• Python 3.12+
• uv (para una gestión rápida de dependencias).
• Docker (opcional, para implementación en contenedores).
• Asegúrese de que su servidor Prometheus Alertmanager sea accesible desde el entorno donde ejecutará este servidor MCP.

3.2. Instalación mediante Smithery

Para instalar Prometheus Alertmanager MCP Server para Claude Desktop automáticamente a través de Smithery :

3.3. Ejecución local

• Clonar el repositorio:

• Configure las variables de entorno para su servidor Prometheus, ya sea a través de un archivo .env o variables de entorno del sistema:

• Agregue la configuración del servidor al archivo de configuración del cliente. Por ejemplo, para Claude Desktop:

• O instálalo usando el comando make:

• Reinicie Claude Desktop para cargar la nueva configuración.
• Ahora puedes pedirle a Claude que interactúe con Alertmanager usando su idioma natural:
  • "Muéstrame las alertas actuales"
  • Filtrar alertas relacionadas con problemas de CPU
  • Obtener detalles de esta alerta
  • "Crear un silencio para esta alerta durante las próximas 2 horas"

3.4. Ejecución de Docker

• Ejecútalo con una imagen preconstruida (o puedes construirla tú mismo):

• Ejecutando con Docker en Claude Desktop:

Esta configuración pasa las variables de entorno de Claude Desktop al contenedor Docker utilizando el indicador -e con solo el nombre de la variable y proporcionando los valores reales en el objeto env .

4. Herramientas

El servidor MCP expone herramientas para consultar y administrar Alertmanager, siguiendo su API v2 :

• Obtener estado: get_status()
• Lista de alertas: get_alerts()
• Lista de silencios: get_silences()
• Crear silencio: post_silence(silence_dict)
• Eliminar silencio: delete_silence(silence_id)
• Lista de receptores: get_receivers()
• Lista de grupos de alerta: get_alert_groups()

Consulte src/alertmanager_mcp_server/server.py para obtener detalles completos de la API.

5. Desarrollo

¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios si tiene alguna sugerencia o mejora.

Este proyecto utiliza uv para gestionar dependencias. Instale uv siguiendo las instrucciones para su plataforma.

6. Licencia

Apache 2.0