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.
Разработка
Подключить MCPОткрыть на GitHub
Подключение

Подключить UniFi MCP Server

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "unifi-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "unifi-mcp-server"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить UniFi MCP Server

UniFi MCP Server относится к Разработка. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
Apache-2.0
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться