zabbix-mcp

Ráno po nočním výpadku chce správce vědět tři věci: co spadlo, na kterém stroji a jak vypadala metrika před incidentem a po něm. V rozhraní Zabbixu to znamená projít seznam problémů, rozkliknout trigger, dohledat položku a otevřít její graf, a u každého dalšího hostitele znovu. zabbix-mcp dá tytéž údaje AI asistentovi. Je to MCP server pro monitoring Zabbix, přes který Claude Code nebo jiný klient protokolu MCP čte hostitele, problémy, triggery, události a historii metrik a umí potvrdit událost.

Proč ne vlastní skript nad API

Zabbix má plnohodnotné JSON-RPC API, jenže skript nad ním odpoví jen na otázku, kterou do něj někdo předem napsal. Navíc API mezi verzemi mění detaily, na kterých skripty padají. Tenhle server s nimi počítá: na Zabbixu starším než 6.4 posílá API token v těle požadavku, protože tyto verze hlavičku Authorization: Bearer ignorují, u hostitelů volí podle verze serveru selectGroups, nebo selectHostGroups, a u skupin se neptá na pole internal, které Zabbix 6.2 odstranil. Model pak skládá dotazy podle toho, co se zrovna děje, a správce nemusí udržovat sbírku skriptů pro každou verzi.

Co z toho má správce

Incident od problému až k metrice

Jedenáct nástrojů pokrývá celou cestu: skupiny hostitelů, hostitelé s rozhraními, makry a inventářem, aktuální i nedávné problémy, časová osa událostí, triggery se závislostmi a štítky, položky s poslední hodnotou a surová historie metriky. Problémy jdou filtrovat podle času (since), závažnosti a toho, jestli už je někdo potvrdil. Na otázku „co se dnes rozbilo a co tomu předcházelo“ tak model odpoví z dat, ne z odhadu.

Mění jen to, co má

Deset z jedenácti nástrojů jen čte. Jediný zapisující, zabbix_acknowledge_event, potvrdí událost, přidá k ní zprávu, potlačí ji, uzavře nebo změní její závažnost. Asistent tak může zapsat poznámku o plánované údržbě, ale konfiguraci hostitelů ani triggerů nezmění. K tomu stačí API token s odpovídajícími právy.

Ověřeno na čtyřech verzích Zabbixu

Verze 0.4.1 je vyzkoušená proti Zabbixu 6.0.48, 7.0.29, 7.4.13 a 8.0.0rc1, všech jedenáct nástrojů včetně stránkování. Adresu serveru přijme ve třech podobách, s /api_jsonrpc.php, s cestou /zabbix i bez ní, a sama ji převede na adresu API.

Velké výsledky nezahltí model

Odpověď delší než 25 000 znaků se zkrátí a nese poznámku, kolik položek vrátila a jak dotaz zúžit. Stránkování se dělá na straně serveru MCP, protože Zabbix parametr offset v metodách .get nemá; u problémů, událostí a historie dostane model od druhé stránky dál nápovědu s kurzorem. Požadavek, který neodpoví do 30 sekund, skončí chybou; chyby HTTP i chyby Zabbixu dorazí ke klientovi s kódem a zprávou.

Jak se zapojí

{
  "mcpServers": {
    "zabbix": {
      "command": "npx",
      "args": ["-y", "@nks-hub/zabbix-mcp"],
      "env": {
        "ZABBIX_URL": "https://monitor.example.com",
        "ZABBIX_API_TOKEN": "your-api-token"
      }
    }
  }
}

Místo tokenu jde použít jméno a heslo (ZABBIX_USERNAME, ZABBIX_PASSWORD), což se hodí pro starší instalace nebo rychlou zkoušku. Ve výchozím stavu server běží jako proces klienta přes standardní vstup a výstup. Režim HTTP od verze 0.4.1 naslouchá jen na 127.0.0.1 a má zapnutou ochranu proti DNS rebindingu; nese totiž API token a vlastní přihlašování nemá, takže by ho jinak mohla ovládat i cizí webová stránka otevřená v prohlížeči. Kdo ho chce zpřístupnit jinde, nastaví MCP_HTTP_HOST, MCP_HTTP_ALLOWED_HOSTS a MCP_HTTP_ALLOWED_ORIGINS.

Typická použití

• Ranní rozbor: skupiny hostitelů, hostitelé, problémy od včerejšího večera, k nim trigger nebo detail hostitele a historie metriky, která problém spustila.
• Plánovaná údržba: asistent najde související poplachy a potvrdí je se zprávou, proč vznikly.
• Podezřelý skok v grafu: vyhledá položku, zkontroluje typ její hodnoty a stáhne historii z doby před skokem a po něm.
• Monitoring vedle analytiky: stejný klient může mít připojený i rybbit-mcp a srovnat výpadek serveru s propadem návštěvnosti.

Stav projektu

Server vznikl v březnu 2026, verze 0.2.0 vyšla 16. března. Verze 0.4.1 z 19. srpna 2026 opravila stránkování, které u čtyř ze sedmi stránkovaných nástrojů končilo chybou a u zbylých tří vracelo pro každou stránku tu první. Zároveň aktualizovala MCP SDK na verzi 1.30, po níž npm audit nehlásí žádnou zranitelnost. V repozitáři jsou skripty pro ruční ověření proti živému Zabbixu s tokenem i se jménem a heslem; automatické testy v CI nejsou, CI projekt sestaví a vydání publikuje na npm.

Jak začít

npx -y @nks-hub/zabbix-mcp
# nebo trvale
npm install -g @nks-hub/zabbix-mcp
# v Claude Code
claude mcp add zabbix -e ZABBIX_URL=https://monitor.example.com -e ZABBIX_API_TOKEN=your-token -- npx -y @nks-hub/zabbix-mcp

Potřeba je Node.js 18 nebo novější a Zabbix se zapnutým API. Token se vytvoří v nastavení uživatele Zabbixu.

Zdrojový kód

Kód je na GitHubu v repozitáři nks-hub/zabbix-mcp pod licencí MIT, napsaný v TypeScriptu. Balíček je na npm jako @nks-hub/zabbix-mcp, poslední verze 0.4.1.