UniFi Safe MCP

Ein fokussierter, schreibgeschützter UniFi Network MCP-Server, der begrenzte Ansichten für Gesundheit, Geräte und aktive Clients bereitstellt. Extrahiert aus dem Commit 2e63f009d8f4642e17398685baef0251811d6637 von spectrenet-mcp; dieses Repository ist eigenständig.

Sicherheitsvertrag

• Genau drei Lese-Tools: network_health, devices und clients; keine Konfigurations-, Befehls-, Übernahme-, Neustart-, Blockierungs- oder andere Mutations-Tools.

• Datenanfragen an Appliances verwenden nur HTTP GET (die Authentifizierung verwendet notwendigerweise POST /api/auth/login).

• TLS-Zertifikats- und Hostname-Überprüfung sind standardmäßig aktiviert.

• Weiterleitungen bei Authentifizierung und Appliance-Daten werden abgelehnt, nicht verfolgt.

• Die konfigurierte Site ist als ein URL-Pfadsegment kodiert, und Endpunkt-Suffixe sind in einer geschlossenen Whitelist.

• HTTP-Antwortbytes, zurückgegebene Listengrößen, projizierte Felder und Audit-Felder sind begrenzt.

• Anmeldeinformationen und vollständige Antworten werden nicht protokolliert.

Related MCP server: UniFi MCP Server

Kompatibilität

Dies zielt auf die UniFi-OS-Konsolen-Proxy-Pfade /api/auth/login und /proxy/network/api/s/{site}/..., die auf modernen UniFi-OS-Appliances beobachtet werden. Ältere selbstgehostete UniFi Network Controller verwenden üblicherweise /api/login und nicht-proxierte /api/s/...; diese werden nicht unterstützt. Ubiquiti ändert private/interne Endpunkte zwischen Appliance- und Network-Application-Versionen. Es ist keine Versionsmatrix zertifiziert: Testen Sie diese Alpha gegen Ihre genaue Konsolen-Firmware und Network-Application-Version in einer Nicht-Produktionsumgebung und pinnen Sie Upgrades betrieblich fest.

Installation und Ausführung

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

Der Server verwendet MCP stdio und lädt keine .env-Datei. Behandeln Sie .env.example nur als gefälschte Dokumentation; injizieren Sie ein dediziertes schreibgeschütztes Konto über einen Supervisor/Secret-Manager.

Verifizieren

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

Siehe Architektur, Kompatibilität und Sicherheit. MIT © 2026 Ben Gauger.