UniFi Access MCP

UniFi Access MCP

sirkirbyMIT
392 звёзд64 форков
UniFi Access MCP — сервер, который подключает AI-ассистентов к системе контроля доступа UniFi. Вы отдаёте команды на естественном языке, ассистент выполняет их: открывает двери, создаёт пропуска, проверяет историю событий. Разработчики и администраторы получают прямой доступ к API UniFi Access без веб-интерфейса. Сервер написан на Python и распространяется по лицензии MIT. Он работает по протоколу MCP через stdio. Ему не нужны открытые порты — весь трафик идёт напрямую между ассистентом и контроллером UniFi в вашей локальной сети. Подключение безопасно и не требует сложной настройки. UniFi Access MCP — часть экосистемы UniFi MCP. В неё входят серверы для UniFi Network (169 инструментов для управления сетью) и UniFi Protect (43 инструмента для видеонаблюдения). Все три сервера можно запустить одновременно, дав одному AI-агенту полный контроль над сетью, камерами и системой доступа.
Открыть на GitHub

Установка

uvx unifi-access-mcp

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

Общее

  • СтатусСообщество
  • Разработчикsirkirby
  • ЛицензияMIT

Технологии

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

Описание

Возможности

  • Управление дверьми и считывателями: открывайте, закрывайте, задавайте режимы работы
  • Работа с учётными данными: создавайте RFID-карты, PIN-коды и мобильные ключи
  • Привязка ключей к сотрудникам, блокировка утерянных карт
  • Настройка политик доступа по расписанию и зонам
  • Управление группами пользователей и массовое назначение прав
  • Выпуск временных пропусков для посетителей с автоматическим истечением срока
  • Аудит безопасности: история проходов с фильтрацией по пользователю, времени и объекту
  • Мониторинг состояния контроллеров и считывателей (онлайн/офлайн)
  • Массовые операции: групповая блокировка или активация учётных данных

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

Для работы потребуется менеджер uv. Если он не установлен, выполните pip install uv.

Установите сервер: uvx unifi-access-mcp

Добавьте конфигурацию в файл claude_desktop_config.json вашего клиента. Пример для Claude Desktop:

{ "mcpServers": { "unifi-access": { "command": "uvx", "args": ["unifi-access-mcp"], "env": { "UNIFI_HOST": "https://unifi.local", "UNIFI_USER": "admin", "UNIFI_PASSWORD": "your_password" } } } }

Укажите актуальный адрес контроллера UniFi OS, имя администратора и пароль. После сохранения файла перезапустите Claude Desktop — инструменты UniFi Access появятся в списке доступных ассистенту. Для Cursor и VS Code конфигурация будет аналогичной.

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

  • Открой дверь в переговорной A-12 и запиши событие в журнал
  • Создай временный пропуск для курьера на вход №3 с 14:00 до 14:30
  • Покажи историю проходов за сегодня. Отфильтруй по сотрудникам отдела разработки
  • Заблокируй все учётные данные сотрудника Сидорова и уведоми службу безопасности

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

  • Разработчик: sirkirby
  • Язык: Python 3.13+
  • Транспорт: stdio
  • Лицензия: MIT
  • Статус: Beta
  • Количество инструментов: 29
  • Совместимые клиенты: Claude Desktop, Cursor, VS Code, любые клиенты MCP

Поделиться