UniFi Safe MCP

Сфокусированный, доступный только для чтения MCP-сервер UniFi Network, предоставляющий ограниченные представления о состоянии, устройствах и активных клиентах. Извлечено из коммита spectrenet-mcp 2e63f009d8f4642e17398685baef0251811d6637; этот репозиторий самодостаточен.

Контракт безопасности

• Ровно три инструмента чтения: network_health, devices и clients; нет инструментов конфигурации, команд, принятия, перезапуска, блокировки или других изменяющих инструментов.

• Запросы данных устройства используют только HTTP GET (аутентификация обязательно использует POST /api/auth/login).

• Проверка TLS-сертификата и имени хоста включена по умолчанию.

• Перенаправления аутентификации и данных устройства отклоняются, а не выполняются.

• Настроенный сайт кодируется как один сегмент пути URL, а суффиксы конечных точек находятся в закрытом белом списке.

• Байты HTTP-ответа, длины возвращаемых списков, проецируемые поля и поля аудита ограничены.

• Учетные данные и полные ответы не аудируются.

Related MCP server: UniFi MCP Server

Совместимость

Это нацелено на пути прокси-консоли UniFi OS /api/auth/login и /proxy/network/api/s/{site}/..., наблюдаемые на современных устройствах UniFi OS. Более старые самостоятельно размещенные контроллеры UniFi Network обычно используют /api/login и непроксированные /api/s/...; они не поддерживаются. Ubiquiti меняет частные/внутренние конечные точки между версиями устройства и Network Application. Никакая матрица версий не сертифицирована: протестируйте эту альфа-версию на вашей точной прошивке консоли и версии Network Application в непроизводственной среде и операционно закрепите обновления.

Установка и запуск

uv sync --extra test
uv run unifi-safe-mcp --help
uv run unifi-safe-mcp

Сервер использует MCP stdio и не загружает .env. Относитесь к .env.example только как к фиктивной документации; внедряйте выделенную учетную запись только для чтения через супервизор/менеджер секретов.

Проверка

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

См. архитектуру, совместимость и безопасность. MIT © 2026 Ben Gauger.