Was macht zabbix-mcp-server?
Verbinden Sie Zabbix mit MCP-Clients für vollständigen API-Zugriff in Claude, Codex, VS Code und JetBrains.
Übersicht
Dieses MCP-Server-Skill ermöglicht KI-Assistenten und Entwicklungsumgebungen die direkte Kommunikation mit der Zabbix-API. Es kapselt Authentifizierung, Abfragen und Datenformatierung, sodass Sie Zabbix-Ressourcen auf natürliche Weise verwalten können, ohne die zugrunde liegenden API-Details zu kennen.
Funktionen
- Host-Abfrage: Listen und durchsuchen Sie Zabbix-Hosts nach Namen oder ID.
- Problem- und Ereignismanagement: Rufen Sie offene Probleme, Trigger und Ereignisverläufe ab.
- Dashboard-Zugriff: Rufen Sie aggregierte Überwachungsdaten und Zusammenfassungen ab.
- Automatisierung: Erstellen, aktualisieren und löschen Sie Konfigurationselemente über API-Befehle.
- Mehrere Plattformen: Funktioniert mit Claude Code, Codex, VS Code und JetBrains-IDEs.
Voraussetzungen
- Ein laufender Zabbix-Server (Version 5.0 oder höher empfohlen).
- Gültige Zabbix-API-Anmeldeinformationen (Benutzername und Passwort).
- MCP-kompatibler Client (z. B. Claude Desktop, VS Code mit MCP-Plugin, JetBrains AI Assistant).
Installation
- Klonen oder laden Sie das Repository herunter:
git clone https://github.com/Rapid-dissolve862/zabbix-mcp-server.git
cd zabbix-mcp-server
- Installieren Sie Abhängigkeiten mit Ihrem bevorzugten Paketmanager (npm/pnpm/yarn).
npm install
- Konfigurieren Sie Umgebungsvariablen oder bereiten Sie eine Konfigurationsdatei vor:
ZABBIX_URL=http://ihr-zabbix-server/zabbix
ZABBIX_USER=api-user
ZABBIX_PASS=api-passwort
- Starten Sie den MCP-Server:
npm start
Nutzung
Konfigurieren Sie in Ihrem MCP-Client die Verbindung zu diesem Server (Details finden Sie in der Dokumentation Ihres Clients). Sobald die Verbindung hergestellt ist, können Sie Befehle wie die folgenden verwenden:
- „Zeige mir alle kritischen Probleme in Zabbix.“
- „Wie viele Hosts sind derzeit im Down-Status?“
- „Erstelle einen neuen Host mit dem Namen ‚webserver-01‘ und der IP-Adresse 192.168.1.10.“
Der Server übersetzt Ihre Anfrage in Zabbix-API-Aufrufe und gibt die Ergebnisse in einem strukturierten, für Menschen lesbaren Format zurück.
API-Referenz
| Tool | Beschreibung | Parameter |
|---|---|---|
get_hosts | Ruft eine Liste aller Hosts ab | optional: filter (name/ip) |
get_problems | Ruft aktuelle Probleme ab | optional: severity, limit |
get_events | Ruft Ereignisverlauf ab | optional: timeRange, hostId |
create_host | Erstellt einen neuen Host | name, ip, groupId (erforderlich) |
delete_host | Löscht einen Host anhand seiner ID | hostId (erforderlich) |
Fehlerbehebung
- Verbindungsfehler: Stellen Sie sicher, dass die URL korrekt ist und der Zabbix-Server erreichbar ist.
- Authentifizierungsfehler: Überprüfen Sie Benutzername und Passwort; der API-Benutzer muss über ausreichende Rechte verfügen.
- Leere Ergebnisse: Passen Sie Filterparameter an; der Server gibt möglicherweise keine Daten zurück, wenn keine Übereinstimmungen gefunden werden.
Contributing
Beiträge sind willkommen! Bitte reichen Sie Issues oder Pull-Requests im GitHub-Repository ein.
Lizenz
MIT