zabbix-mcp-server

zabbix-mcp-server — MCP-сервер сообщества (автор — mpeirone). Интеграция с Zabbix: хосты, триггеры, шаблоны и проблемы. Ставится через Docker. Лицензия GPL-3.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
mpeirone
Лицензия
GPL-3.0
Транспорт
stdio
Авторизация
api_key
ОС
linux, macos, windows
Языки
python

Уровень риска: high

zabbix_api выполняет любой метод API, включая create и delete; ограничивается READ_ONLY и списками методов.

Настройка клиентов

claude-code
{
    "code": "claude mcp add zabbix \\\n  --env ZABBIX_URL=https://your-zabbix-server.com \\\n  --env ZABBIX_TOKEN=your_api_token \\\n  -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp",
    "lang": "bash",
    "notes": "Дословно из README; подставьте адрес сервера и токен",
    "verified": "docs"
}

Что умеет

Zabbix MCP Server даёт ИИ-агенту доступ к API системы мониторинга Zabbix. Вместо десятков отдельных инструментов сервер предоставляет всего три, поэтому контекст модели остаётся компактным, а все методы API (больше 100) доступны через единый интерфейс:

Инструмент Назначение
zabbix_api выполнить любой метод API Zabbix
zabbix_api_docs получить документацию по методу
zabbix_api_list посмотреть доступные объекты и методы

Сервер автоматически работает с текущими и будущими методами API и поддерживает Zabbix 6.0, 6.4, 7.0 и новее. Через него можно получать список узлов и актуальные проблемы, создавать узлы с интерфейсами, изучать документацию методов прямо в диалоге.

Кому подойдёт

  • Администраторам и инженерам эксплуатации: быстрые ответы о состоянии инфраструктуры без ручной работы в веб-интерфейсе.
  • Тем, кто автоматизирует настройку мониторинга: создание и изменение узлов, элементов данных и других объектов.
  • Командам с ограниченными правами: режим только для чтения и фильтры методов.

Похожие серверы — в категории облака и DevOps.

Установка

Нужен uv. Сервер запускается через uvx прямо из репозитория. Обязательная переменная — ZABBIX_URL. Для входа используйте ZABBIX_TOKEN (рекомендуется) или пару ZABBIX_USER и ZABBIX_PASSWORD. Храните токен в переменной окружения и не публикуйте конфиг с реальным значением.

Настройки безопасности:

  • READ_ONLY=true — разрешены только операции get, version, check и export;
  • ZABBIX_API_WHITELIST и ZABBIX_API_BLACKLIST — списки регулярных выражений для разрешённых и запрещённых методов, чёрный список проверяется первым;
  • VERIFY_SSL — проверка сертификата (по умолчанию включена);
  • ZABBIX_API_TIMEOUT — таймаут запроса, по умолчанию 30 секунд.

Есть также запуск из клона репозитория через uv run и вариант с Docker. Транспорт по умолчанию — stdio; для streamable-http сервер слушает 127.0.0.1:8000.

Подключение к клиентам

Команда и конфиг приведены дословно из README. Замените адрес сервера и токен своими значениями. Подробнее — в инструкции как подключить MCP.

claude mcp add zabbix \
  --env ZABBIX_URL=https://your-zabbix-server.com \
  --env ZABBIX_TOKEN=your_api_token \
  -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Конфиг Claude Desktop добавляют в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

Проверка

Попросите агента вызвать zabbix_api_list для объекта host. В ответе должен быть список методов узлов. Затем запросите host.get — агент вернёт идентификаторы и имена узлов. Из клона репозитория соединение проверяет скрипт scripts/test_server.py.

Примеры задач

Покажи текущие проблемы Zabbix за последний час, сгруппированные по узлам.
Какие параметры у метода host.create? Подготовь вызов для нового сервера, но не выполняй его.

Риски

  • Изменения в Zabbix. zabbix_api выполняет любой метод, включая создание и удаление объектов. Для разведки включайте READ_ONLY=true или запрещайте .create и .delete через чёрный список.
  • Секреты. Токен или пароль Zabbix передаются через переменные окружения; дайте учётной записи минимальные права.
  • Сеть. Сервер обращается к вашему серверу Zabbix; не отключайте VERIFY_SSL без необходимости.
  • HTTP-режим требует AUTH_TYPE=no-auth, то есть работает без аутентификации — не открывайте его наружу.

Частые вопросы

Почему всего три инструмента?

Так модель не тратит контекст на описания десятков методов: она находит нужный через zabbix_api_list и читает документацию через zabbix_api_docs.

Какие версии Zabbix поддерживаются?

6.0, 6.4, 7.0 и новее. Проверку версии можно отключить через ZABBIX_SKIP_VERSION_CHECK.

Что делать при ошибке «метод не в белом списке»?

Проверьте шаблоны ZABBIX_API_WHITELIST и ZABBIX_API_BLACKLIST: выражение должно совпадать с полным именем метода, например host.get.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники