unifi-mcp-server

unifi-mcp-server

enunoApache-2.0
156 звёзд25 форков
UniFi MCP Server — это сервер для протокола MCP, который подключается к контроллеру UniFi Network по официальному API. Вы можете через него управлять сетевой инфраструктурой: AP, коммутаторами, шлюзами, гостевыми сетями и политиками безопасности с помощью AI-агентов. Сервер написан на Python, поддерживает транспорт stdio и SSE/HTTP. Совместим с UniFi Network Controller версии 9.x.
Development
Открыть на GitHub

Установка

npx -y unifi-mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчикenuno
  • ЛицензияApache-2.0

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Просматривайте статус, метрики и список клиентов всех устройств UniFi.
  • Управляйте точками доступа: включение, отключение, смена частоты и мощности сигнала.
  • Настраивайте VLAN и сегментацию сети для разных отделов или гостей.
  • Создавайте и редактируйте учетные записи RADIUS и гостевые порталы (полный CRUD).
  • Применяйте политики безопасности: файрвол-правила, QoS, блокировки по расписанию.
  • Запускайте резервное копирование конфигурации контроллера.
  • Просматривайте историю событий и аудит изменений.
  • Управляйте портами коммутаторов: отключение, настройка PoE.
  • Работайте с облачными объектами через UniFi Site Manager.
  • Автоматизируйте массовые операции через запросы к AI-ассистенту.

Как подключить

Установите сервер через pip:

pip install unifi-mcp-server

Или запустите напрямую через npx (подходит для быстрой настройки):

npx -y unifi-mcp-server

Настройте переменные окружения для подключения к контроллеру:

  • UNIFI_HOST — адрес контроллера
  • UNIFI_USERNAME — имя пользователя API
  • UNIFI_PASSWORD — пароль
  • UNIFI_PORT — порт (по умолчанию 443)
  • UNIFI_SITE — имя сайта (по умолчанию "default")

Добавьте конфигурацию в Claude Desktop:

{ "mcpServers": { "unifi": { "command": "npx", "args": ["-y", "unifi-mcp-server"], "env": { "UNIFI_HOST": "192.168.1.1", "UNIFI_USERNAME": "admin", "UNIFI_PASSWORD": "password" } } } }

Перезапустите Claude Desktop. Сервер подключится автоматически.

Для режима SSE (интеграция через MCP-шлюз) укажите переменные:

UNIFI_TRANSPORT_MODE=sse UNIFI_HTTP_PORT=8000

Примеры запросов

  • Покажи список всех активных клиентов с их MAC-адресами и скоростью соединения.
  • Настрой гостевую сеть для конференц-зала и создай временные пароли для участников.
  • Отключи порт коммутатора, на котором подключено неизвестное устройство.
  • Создай резервную копию конфигурации контроллера UniFi и сохрани в локальную папку.
  • Примени правило файрвола для блокировки доступа к определенному IP-адресу.

Технические детали

  • Язык: Python 3.10+
  • Транспорт: stdio, SSE (опционально)
  • Лицензия: Apache 2.0
  • Совместимые клиенты: Claude Desktop, любые MCP-клиенты (stdio/HTTP)
  • Требования: UniFi Network Controller 9.x, API-доступ с правами администратора
  • Репозиторий: github.com/enuno/unifi-mcp-server

Поделиться