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.

Inhaltsverzeichnis

1. Einleitung

Prometheus Alertmanager MCP ist ein Model Context Protocol (MCP)-Server für Prometheus Alertmanager. Er ermöglicht KI-Assistenten und -Tools die programmgesteuerte und sichere Abfrage und Verwaltung von Alertmanager-Ressourcen.

2. Funktionen

  • [x] Abfrage des Alertmanager-Status, der Alarme, der Stummschaltungen, der Empfänger und der Alarmgruppen
  • [x] Stille erstellen, aktualisieren und löschen
  • [x] Neue Benachrichtigungen erstellen
  • [x] Authentifizierungsunterstützung (Basisauthentifizierung über Umgebungsvariablen)
  • [x] Unterstützung für Docker-Containerisierung

3. Schnellstart

3.1. Voraussetzungen

  • Python 3.12+
  • uv (für schnelles Abhängigkeitsmanagement).
  • Docker (optional, für die Bereitstellung in Containern).
  • Stellen Sie sicher, dass Ihr Prometheus Alertmanager-Server von der Umgebung aus zugänglich ist, in der Sie diesen MCP-Server ausführen.

3.2. Lokaler Lauf

  • Klonen Sie das Repository:
# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git
  • Konfigurieren Sie die Umgebungsvariablen für Ihren Prometheus-Server, entweder über eine .env-Datei oder über Systemumgebungsvariablen:
# Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional
  • Fügen Sie die Serverkonfiguration zu Ihrer Client-Konfigurationsdatei hinzu. Beispiel für 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. Docker-Ausführung

  • Führen Sie es mit einem vorgefertigten Image aus (oder Sie können es selbst erstellen):
$ 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
  • Ausführen mit Docker in 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" } } } }

Diese Konfiguration übergibt die Umgebungsvariablen von Claude Desktop an den Docker-Container, indem sie das Flag -e nur mit dem Variablennamen verwendet und die tatsächlichen Werte im env bereitstellt.

4. Werkzeuge

Der MCP-Server stellt Tools zum Abfragen und Verwalten von Alertmanager bereit, gemäß seiner API v2 :

  • Status abrufen: get_status()
  • Warnmeldungen auflisten: get_alerts()
  • Auflisten von Stille: get_silences()
  • Stille erzeugen: post_silence(silence_dict)
  • Stille löschen: delete_silence(silence_id)
  • Empfänger auflisten: get_receivers()
  • Alarmgruppen auflisten: get_alert_groups()

Vollständige API-Details finden Sie unter src/alertmanager_mcp_server/server.py .

5. Entwicklung

Beiträge sind willkommen! Bitte melden Sie ein Problem oder senden Sie einen Pull Request, wenn Sie Vorschläge oder Verbesserungen haben.

Dieses Projekt verwendet UV zur Verwaltung von Abhängigkeiten. Installieren Sie UV gemäß den Anweisungen für Ihre Plattform.

# 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. Lizenz

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.

Alertmanager-MCP-Server

  1. Einleitung
    1. Funktionen
      1. Schnellstart
        1. 3.1. Voraussetzungen
        2. 3.2. Lokaler Lauf
        3. 3.3. Docker-Ausführung
      2. Werkzeuge
        1. Entwicklung
          1. Lizenz

            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