UniFi Safe MCP

Un servidor MCP de UniFi Network enfocado y de solo lectura que proporciona vistas limitadas de salud, dispositivos y clientes activos. Extraído del commit 2e63f009d8f4642e17398685baef0251811d6637 de spectrenet-mcp; este repositorio es autónomo.

Contrato de seguridad

• Exactamente tres herramientas de lectura: network_health, devices y clients; sin herramientas de configuración, comando, adopción, reinicio, bloqueo u otras herramientas de mutación.

• Las solicitudes de datos del dispositivo usan solo HTTP GET (la autenticación necesariamente usa POST /api/auth/login).

• La verificación del certificado TLS y del nombre de host está habilitada por defecto.

• Las redirecciones de autenticación y de datos del dispositivo se rechazan en lugar de seguirse.

• El sitio configurado se codifica como un segmento de ruta URL, y los sufijos de endpoint están en una lista blanca cerrada.

• Los bytes de respuesta HTTP, las longitudes de las listas devueltas, los campos proyectados y los campos de auditoría están limitados.

• Las credenciales y las respuestas completas no se auditan.

Related MCP server: UniFi MCP Server

Compatibilidad

Esto apunta a las rutas de proxy de la consola UniFi OS /api/auth/login y /proxy/network/api/s/{site}/..., observadas en dispositivos modernos con UniFi OS. Los controladores UniFi Network autoalojados más antiguos suelen usar /api/login y /api/s/... sin proxy; esos no son compatibles. Ubiquiti cambia los endpoints privados/internos entre versiones de dispositivo y de Network Application. No se certifica ninguna matriz de versiones: prueba esta versión alfa contra tu firmware de consola y versión de Network Application exactos en un entorno que no sea de producción, y fija las actualizaciones operativamente.

Instalar y ejecutar

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

El servidor usa MCP stdio y no carga .env. Trata .env.example como documentación falsa únicamente; inyecta una cuenta dedicada de solo lectura a través de un supervisor/gestor de secretos.

Verificar

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

Consulta arquitectura, compatibilidad y seguridad. MIT © 2026 Ben Gauger.