alertmanager-mcp-server

Apache 2.0
  • Linux
  • Apple

Integrations

  • Supports containerized deployment of the MCP server through Docker, with configuration via environment variables for connecting to Alertmanager instances.

  • Enables querying and managing Prometheus Alertmanager resources including status, alerts, silences, receivers, and alert groups. Supports creating new alerts, managing silences (create, update, delete), and retrieving alert information through the Alertmanager API v2.

Tabla de contenido

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. Ejecución local

  • Clonar el repositorio:
# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git
  • Configure las variables de entorno para su servidor Prometheus, ya sea a través de un archivo .env o variables de entorno del sistema:
# Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional
  • Agregue la configuración del servidor al archivo de configuración del cliente. Por ejemplo, para Claude Desktop:
{ "mcpServers": { "alertmanager": { "command": "uv", "args": [ "--directory", "<full path to alertmanager-mcp-server directory>", "run", "src/alertmanager_mcp_server/server.py" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

3.3. Ejecución de Docker

  • Ejecútalo con una imagen preconstruida (o puedes construirla tú mismo):
$ docker run -e ALERTMANAGER_URL=http://your-alertmanager:9093 \ -e ALERTMANAGER_USERNAME=your_username \ -e ALERTMANAGER_PASSWORD=your_password \ -p 8000:8000 ghcr.io/ntk148v/alertmanager-mcp-server
  • Ejecutando con Docker en Claude Desktop:
{ "mcpServers": { "alertmanager": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "ALERTMANAGER_URL", "-e", "ALERTMANAGER_USERNAME", "-e", "ALERTMANAGER_PASSWORD", "ghcr.io/ntk148v/alertmanager-mcp-server:latest" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

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.

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git $ uv venv $ source .venv/bin/activate # On Unix/macOS $ .venv\Scripts\activate # On Windows $ uv pip install -e . # run test $ pytest

6. Licencia

Apache 2.0


You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

servidor de alertas mcp

  1. Introducción
    1. Características
      1. Inicio rápido
        1. 3.1. Requisitos previos
        2. 3.2. Ejecución local
        3. 3.3. Ejecución de Docker
      2. Herramientas
        1. Desarrollo
          1. Licencia

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A simple MCP server that can send notifications on mac devices.
              Last updated -
              5
              9
              8
              TypeScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              The MCP server that keeps you informed by sending the notification on phone using ntfy.sh
              Last updated -
              18
              6
              JavaScript
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            ID: oblhy82ylg