UniFi MCP server
MCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
- 340 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Изменение правил сети или перезапуск устройства может прервать соединение пользователей.
- Сервер получает сведения о клиентах и устройствах выбранных сайтов UniFi.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/unifi-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Изменение правил сети или перезапуск устройства может прервать соединение пользователей.
- Сервер получает сведения о клиентах и устройствах выбранных сайтов UniFi.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UniFi MCP server связывает MCP-клиента с UniFi Network, Protect и облачными API UniFi. Агент может получать сведения о клиентах, устройствах и состоянии сети. Через тот же интерфейс доступны настройки Wi-Fi, правила межсетевого экрана и операции с резервными копиями. Изменения требуют параметра подтверждения и поддерживают предварительный просмотр. Набор доступных инструментов можно ограничить профилем и режимом чтения; для нескольких контроллеров предусмотрен отдельный режим с общим реестром и ролями доступа.
Для кого. Для администраторов собственной инфраструктуры UniFi, которым нужна диагностика через MCP-клиент.
Подходит, если
- Нужно выяснить, почему клиент теряет соединение
- Нужно проверить настройки Wi-Fi и каналов
- Нужно сравнить состояние нескольких контроллеров
- Нужно подготовить изменение сети с предварительным просмотром
Не подходит, если
- Используется оборудование другого производителя
- Нет разрешения на администрирование выбранной сети
- Нужен инструмент без ключа и доступа к контроллеру
Пример запроса к агенту
В режиме чтения проверь состояние сети UniFi и объясни возможную причину обрывов у этого клиента.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
UNIFI_API_KEYобязательная, секрет- Ключ API UniFi для выбранных сайтов.
UNIFI_LOCAL_HOST- Адрес контроллера в локальном режиме.
Ограничения
Нужны Python 3.11 или новее и API-ключ UniFi, которому доступны выбранные сайты. Режимы `cloud-ea` и `cloud-v1` не управляют отдельными устройствами; для настройки контроллера нужен режим `local`. Некоторые операции зависят от прошивки контроллера, а для зон межсетевого экрана нужен UniFi Network 9.0 или новее. Сетевые транспорты требуют отдельного токена MCP, поэтому перед подключением удаленного клиента нужно настроить его проверку и не оставлять сервер без авторизации.
Как отключить. Удалите запись сервера из настроек MCP-клиента и отзовите его API-ключ UniFi, если он больше не нужен.
Частые вопросы
Есть режим только чтения?
Да. Включите `UNIFI_READ_ONLY=true`, чтобы убрать изменяющие инструменты.
Как подтвердить изменение и посмотреть его заранее?
Вызову нужен `confirm=True`; `dry_run=True` показывает план без применения. Это параметры инструмента: согласование с человеком нужно обеспечить в MCP-клиенте.
Это официальный сервер Ubiquiti?
Нет. Это сервер сообщества от enuno, работающий с API UniFi.
Что требуется для нескольких контроллеров?
Дополнительный режим использует Postgres и Redis. Он устанавливается отдельно от базового варианта.
Почему не видны готовые подсказки?
Клиент может поддерживать только инструменты. Подсказки требуют стандартных операций MCP для промптов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНабор MCP-серверов для UniFi: агент работает с контроллерами Network, Protect и Access компании Ubiquiti
Zabbix MCP Server (mpeirone)
Zabbix MCP Server
MCP-сервер открывает агенту методы Zabbix API через вызов, справку и поиск методов с настройками чтения и разрешенных операций.
MCP-сервер для роутеров MikroTik: агент читает и меняет конфигурацию RouterOS по SSH по запросу из чата
Zabbix MCP Server
zabbix-mcp-server
MCP-сервер для всего API Zabbix: 237 инструментов, несколько серверов Zabbix, токены с областями и режим только чтения
Официальный MCP-сервер Cloudflare: агент управляет всем API Cloudflare через поиск по спецификации и выполнение кода
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Коротко о README
Сервер предлагает готовые операционные подсказки для проверки сети и планирования изменений. Для развертывания есть контейнер, Ansible и Helm.