Zabbix MCP Server (mpeirone)
Zabbix MCP Server
MCP-сервер открывает агенту методы Zabbix API через вызов, справку и поиск методов с настройками чтения и разрешенных операций.
- 260 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Сервер по умолчанию позволяет агенту выполнять все API-методы его роли, включая административные изменения системы мониторинга.
Установка
- Работает в
Ручная установка
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Первый функциональный пример Quick Start. Адрес и токен в нем шаблонные; настройте реальные значения приватно и ограничьте операции.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер по умолчанию позволяет агенту выполнять все API-методы его роли, включая административные изменения системы мониторинга.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Zabbix MCP Server дает агенту общий интерфейс к API вашей системы мониторинга. Один инструмент выполняет метод, второй показывает его документацию, третий перечисляет доступные объекты. Агент может начать с изучения метода и затем запросить узлы или текущие проблемы. По умолчанию сервер не ограничен чтением, поэтому допустимы и изменения в пределах роли Zabbix. Администратор может включить режим чтения и фильтры методов. Такое подключение требует заранее выбрать, какие данные и действия действительно нужны агенту.
Для кого. Дежурным инженерам Zabbix, которые хотят разбирать проблемы мониторинга через агента с ограниченным набором методов.
Подходит, если
- Во время инцидента нужно собрать узлы и текущие проблемы из Zabbix.
- Перед запросом агенту требуется точное описание параметров API-метода.
- Команда хочет оставить доступ только к чтению выбранных объектов.
- Для отдельной административной задачи нужен заранее согласованный метод API.
Не подходит, если
- Сервер планируют выставить по HTTP без внешней защиты доступа.
- У агента административный токен, но разрешенные методы никто не проверил.
- Нужна панель управления доступами MCP-клиентов внутри самого инструмента.
Пример запроса к агенту
В режиме чтения собери активные проблемы Zabbix и свяжи их с узлами. Конфигурацию мониторинга не меняй.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
ZABBIX_URLобязательная- Адрес своего Zabbix.
ZABBIX_TOKENобязательная, секрет- Токен API Zabbix с нужной ролью.
READ_ONLY- Значение true ограничивает методы чтением.
Ограничения
Требуется Zabbix 6.0 или новее и API-доступ с подходящими правами пользователя. `READ_ONLY` по умолчанию выключен, а разрешающий шаблон допускает все методы, поэтому безопасный набор нужно настроить явно. При HTTP-подключении сервер не проверяет, кто к нему обращается, поэтому ограничьте доступ на уровне сети. Фильтры сравниваются с полными именами методов, а запрет имеет приоритет над разрешением; ошибки шаблонов могут закрыть нужную операцию или открыть лишнюю.
Как отключить. Уберите MCP-подключение, остановите сервер и отзовите его токен Zabbix, если он больше не используется. Проверьте выполненные изменения отдельно.
Частые вопросы
Как разрешить только чтение?
Установите `READ_ONLY=true`. Дополнительно ограничьте роль токена в самом Zabbix.
Что делать при Method is blacklisted?
Проверьте запретный шаблон для полного имени метода. Не снимайте ограничения целиком ради одной операции.
Как узнать параметры метода?
Запросите `zabbix_api_docs` с именем метода, затем подготовьте параметры вызова.
Что важнее: разрешающий или запрещающий список?
Сначала проверяется запрещающий. При пересечении метод будет заблокирован.
Нужно ли включать проверку сертификата?
Она включена по умолчанию. Сохраните ее для рабочего соединения и настройте доверенный сертификат сервера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыZabbix MCP Server
zabbix-mcp-server
MCP-сервер для всего API Zabbix: 237 инструментов, несколько серверов Zabbix, токены с областями и режим только чтения
MCP-сервер для Prometheus: агент выполняет PromQL-запросы, ищет метрики и проверяет цели сбора
MCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
Grafana MCP Server
Grafana MCP server
Официальный MCP-сервер Grafana: дашборды, запросы к Prometheus и Loki, алерты и инциденты прямо из агента
Официальный управляемый MCP-сервер Datadog: логи, метрики, трейсы и инциденты прямо в агенте
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
Коротко о README
Сервер поддерживает stdio и Streamable HTTP. Время ожидания API и диагностический вывод настраиваются через окружение.