UniFi MCP
Набор MCP-серверов для UniFi: агент работает с контроллерами Network, Protect и Access компании Ubiquiti
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Работает с сетевой инфраструктурой и системами доступа
- Требует учетные данные контроллера UniFi
- Изменяющие операции затрагивают боевую сеть
Установка
Ручная установка
uvx unifi-network-mcp@latestПрямой запуск сервера Network из PyPI. Для Protect и Access используйте unifi-protect-mcp и unifi-access-mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект собирает отдельные MCP-серверы под приложения UniFi: Network, Protect и Access. Каждый сервер отдает функции своего приложения как инструменты MCP, которые можно запрашивать и составлять в цепочки, при этом по умолчанию поведение безопасное. Инструменты только на чтение поддерживают веерный запрос по нескольким локациям, а изменяющие операции требуют явно указать целевую локацию. Серверы ставятся через uvx с PyPI или как плагины из маркетплейса, есть транспорт stdio и опциональный HTTP для доверенных локальных клиентов. Для удаленного доступа предусмотрен облачный релей через воркер и сайдкар.
Для кого. Для сетевых и devops-инженеров, которые обслуживают оборудование Ubiquiti UniFi.
Подходит, если
- Нужно опрашивать контроллер UniFi Network из агента
- Нужно работать с камерами и событиями UniFi Protect
- Нужно управлять доступом через UniFi Access
Не подходит, если
- Нет учетных данных контроллера UniFi
- Не хотите давать агенту доступ к сетевой инфраструктуре
- Нужен удаленный доступ без настройки защищенного релея
Пример запроса к агенту
Покажи подключенные клиенты в сети UniFi и список точек доступа с их состояниемОграничения
Нужны адрес и учетные данные контроллера UniFi, обычно логин и пароль в переменных окружения. Требуется Python 3.13 и новее. HTTP-транспорт выключен по умолчанию и не аутентифицирован, он рассчитан на доверенные локальные клиенты, для внешнего доступа нужен защищенный прокси или облачный релей. Серверы Protect, Access и релей помечены как beta.
Как отключить. Удалите записи серверов unifi из конфигурации MCP клиента или удалите установленные плагины через /plugin. При установке через uvx достаточно убрать записи из конфигурации.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| UNIFI_NETWORK_HOST обязательная | Адрес контроллера UniFi Network |
| UNIFI_NETWORK_USERNAME обязательная | Логин для контроллера UniFi |
| UNIFI_NETWORK_PASSWORD обязательная, секрет | Пароль для контроллера UniFi |
Проверка безопасности
- Работает с сетевой инфраструктурой и системами доступа
- Требует учетные данные контроллера UniFi
- Изменяющие операции затрагивают боевую сеть
Коротко о README
README описывает коллекцию MCP-серверов для UniFi по приложениям Network, Protect и Access, каждый со своим пакетом на PyPI. Показаны установка через плагины из маркетплейса для Claude Code, Codex и OpenClaw, а также прямой запуск через uvx с переменными UNIFI_NETWORK_HOST, USERNAME и PASSWORD. Отдельно разобраны модель безопасности транспорта, режимы ответа под версию протокола MCP и облачный релей на базе воркера Cloudflare и локального сайдкара. Есть также независимый HTTP-сервис API. Лицензия MIT.
Частые вопросы
Это один сервер или несколько?
Несколько. Отдельные серверы для Network, Protect и Access, каждый ставится своим пакетом с PyPI.
Как открыть удаленный доступ?
Через облачный релей: воркер как защищенная точка входа и локальный сайдкар, который держит исходящее соединение. HTTP напрямую рассчитан только на доверенные локальные клиенты.
Похожие
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг