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. Installation über Smithery

So installieren Sie den Prometheus Alertmanager MCP Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @ntk148v/alertmanager-mcp-server --client claude

3.3. 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"
      }
    }
  }
}

Oder installieren Sie es mit dem Befehl „make“:

$ make install

Starten Sie Claude Desktop neu, um die neue Konfiguration zu laden.
Sie können Claude jetzt bitten, in natürlicher Sprache mit Alertmanager zu interagieren:
- „Zeige mir aktuelle Warnungen“
- „Filtern Sie Warnungen im Zusammenhang mit CPU-Problemen“
- „Details zu dieser Warnung abrufen“
- „Diesen Alarm für die nächsten 2 Stunden stummschalten“

3.4. 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
$ cd alertmanager-mcp-server
$ make setup
# Run test
$ make test
# Run in development mode
$ mcp dev
$ TRANSPORT_MODE=sse mcp dev

# Install in Claude Desktop
$ make install