UniFi MCP
Набор MCP-серверов для UniFi: агент работает с контроллерами Network, Protect и Access компании Ubiquiti
- 1 044 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Работает с сетевой инфраструктурой и системами доступа
- Требует учетные данные контроллера UniFi
- Изменяющие операции затрагивают боевую сеть
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/unifi-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Работает с сетевой инфраструктурой и системами доступа
- Требует учетные данные контроллера UniFi
- Изменяющие операции затрагивают боевую сеть
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект собирает отдельные MCP-серверы под приложения UniFi: Network, Protect и Access. Каждый сервер отдает функции своего приложения как инструменты MCP, которые можно запрашивать и составлять в цепочки, при этом по умолчанию поведение безопасное. Инструменты только на чтение поддерживают веерный запрос по нескольким локациям, а изменяющие операции требуют явно указать целевую локацию. Серверы ставятся через uvx с PyPI или как плагины из маркетплейса, есть транспорт stdio и опциональный HTTP для доверенных локальных клиентов. Для удаленного доступа предусмотрен облачный релей через воркер и сайдкар.
Для кого. Для сетевых и devops-инженеров, которые обслуживают оборудование Ubiquiti UniFi.
Подходит, если
- Нужно опрашивать контроллер UniFi Network из агента
- Нужно работать с камерами и событиями UniFi Protect
- Нужно управлять доступом через UniFi Access
Не подходит, если
- Нет учетных данных контроллера UniFi
- Не хотите давать агенту доступ к сетевой инфраструктуре
- Нужен удаленный доступ без настройки защищенного релея
Пример запроса к агенту
Покажи подключенные клиенты в сети UniFi и список точек доступа с их состояниемMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
UNIFI_NETWORK_HOSTобязательная- Адрес контроллера UniFi Network
UNIFI_NETWORK_USERNAMEобязательная- Логин для контроллера UniFi
UNIFI_NETWORK_PASSWORDобязательная, секрет- Пароль для контроллера UniFi
Ограничения
Нужны адрес и учетные данные контроллера UniFi, обычно логин и пароль в переменных окружения. Требуется Python 3.13 и новее. HTTP-транспорт выключен по умолчанию и не аутентифицирован, он рассчитан на доверенные локальные клиенты, для внешнего доступа нужен защищенный прокси или облачный релей. Серверы Protect, Access и релей помечены как beta.
Как отключить. Удалите записи серверов unifi из конфигурации MCP клиента или удалите установленные плагины через /plugin. При установке через uvx достаточно убрать записи из конфигурации.
Частые вопросы
Это один сервер или несколько?
Несколько. Отдельные серверы для Network, Protect и Access, каждый ставится своим пакетом с PyPI.
Как открыть удаленный доступ?
Через облачный релей: воркер как защищенная точка входа и локальный сайдкар, который держит исходящее соединение. HTTP напрямую рассчитан только на доверенные локальные клиенты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
MCP-сервер Juniper: агент выполняет команды и пакетные запросы на маршрутизаторах Junos с блок-листами опасных действий.
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
CLI и TUI для контроллеров UniFi: устройства, клиенты, VLAN, фаервол и VPN из терминала, плюс скилл для кодовых агентов
Официальный MCP-сервер Cloudflare: агент управляет всем API Cloudflare через поиск по спецификации и выполнение кода
MCP-сервер для MikroTik RouterOS и SwOS: 133 типизированных инструмента с пробным прогоном, снимками и откатом изменений.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| UniFi MCP (эта карточка) | нет | API-ключ | 1 044 | |
| kubectl-mcp-server | нет | не нужна | 972 | читает состояние кластера и разбирает сбои подов |
| Unreal Engine MCP Server | нет | не нужна | 1 033 | ассеты, акторы и блупринты Unreal Engine |
| Android MCP | нет | не нужна | 924 | управляет Android-устройством через ADB |
Коротко о README
README описывает коллекцию MCP-серверов для UniFi по приложениям Network, Protect и Access, каждый со своим пакетом на PyPI. Показаны установка через плагины из маркетплейса для Claude Code, Codex и OpenClaw, а также прямой запуск через uvx с переменными UNIFI_NETWORK_HOST, USERNAME и PASSWORD. Отдельно разобраны модель безопасности транспорта, режимы ответа под версию протокола MCP и облачный релей на базе воркера Cloudflare и локального сайдкара. Есть также независимый HTTP-сервис API. Лицензия MIT.