UniFi

Name: UniFi
Author: mattoddie

von mattoddieVersion 0.6.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.mattoddie/unifi-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Manage a Ubiquiti UniFi network: devices, clients, WiFi, firewall and VPN. Read-only by default.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Cybersicherheit
Das musst du eintragen: UNIFI_URL, UNIFI_API_KEY, UNIFI_PASSWORD

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: MCP_TRANSPORT, UNIFI_URL, UNIFI_API_KEY, UNIFI_USERNAME, UNIFI_PASSWORD, UNIFI_TLS_FINGERPRINT, UNIFI_VERIFY_SSL, UNIFI_SITE, UNIFI_ALLOW_WRITES, UNIFI_ALLOW_DELETES, UNIFI_TOOLSETS, UNIFI_AUDIT_LOG

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

DockerDocker installiert

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Die .mcpb-Datei des Entwicklers herunterladen

Der Link führt zur Datei des Entwicklers selbst; wir hosten sie nicht und verpacken sie nicht neu. Öffne die Datei, dann installiert Claude Desktop sie.

Führe das in deinem Terminal aus

claude mcp add unifi --env MCP_TRANSPORT=your-value --env UNIFI_URL=your-value --env UNIFI_API_KEY=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value --env UNIFI_TLS_FINGERPRINT=your-value --env UNIFI_VERIFY_SSL=your-value --env UNIFI_SITE=your-value --env UNIFI_ALLOW_WRITES=your-value --env UNIFI_ALLOW_DELETES=your-value --env UNIFI_TOOLSETS=your-value --env UNIFI_AUDIT_LOG=your-value -- docker run -i --rm -e MCP_TRANSPORT -e UNIFI_URL -e UNIFI_API_KEY -e UNIFI_USERNAME -e UNIFI_PASSWORD -e UNIFI_TLS_FINGERPRINT -e UNIFI_VERIFY_SSL -e UNIFI_SITE -e UNIFI_ALLOW_WRITES -e UNIFI_ALLOW_DELETES -e UNIFI_TOOLSETS -e UNIFI_AUDIT_LOG ghcr.io/mattoddie/unifi-mcp:0.6.1

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "UNIFI_URL",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_USERNAME",
        "-e",
        "UNIFI_PASSWORD",
        "-e",
        "UNIFI_TLS_FINGERPRINT",
        "-e",
        "UNIFI_VERIFY_SSL",
        "-e",
        "UNIFI_SITE",
        "-e",
        "UNIFI_ALLOW_WRITES",
        "-e",
        "UNIFI_ALLOW_DELETES",
        "-e",
        "UNIFI_TOOLSETS",
        "-e",
        "UNIFI_AUDIT_LOG",
        "ghcr.io/mattoddie/unifi-mcp:0.6.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "UNIFI_URL": "your-value",
        "UNIFI_API_KEY": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_TLS_FINGERPRINT": "your-value",
        "UNIFI_VERIFY_SSL": "your-value",
        "UNIFI_SITE": "your-value",
        "UNIFI_ALLOW_WRITES": "your-value",
        "UNIFI_ALLOW_DELETES": "your-value",
        "UNIFI_TOOLSETS": "your-value",
        "UNIFI_AUDIT_LOG": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "unifi": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "UNIFI_URL",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_USERNAME",
        "-e",
        "UNIFI_PASSWORD",
        "-e",
        "UNIFI_TLS_FINGERPRINT",
        "-e",
        "UNIFI_VERIFY_SSL",
        "-e",
        "UNIFI_SITE",
        "-e",
        "UNIFI_ALLOW_WRITES",
        "-e",
        "UNIFI_ALLOW_DELETES",
        "-e",
        "UNIFI_TOOLSETS",
        "-e",
        "UNIFI_AUDIT_LOG",
        "ghcr.io/mattoddie/unifi-mcp:0.6.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "UNIFI_URL": "your-value",
        "UNIFI_API_KEY": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_TLS_FINGERPRINT": "your-value",
        "UNIFI_VERIFY_SSL": "your-value",
        "UNIFI_SITE": "your-value",
        "UNIFI_ALLOW_WRITES": "your-value",
        "UNIFI_ALLOW_DELETES": "your-value",
        "UNIFI_TOOLSETS": "your-value",
        "UNIFI_AUDIT_LOG": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

MCP_TRANSPORT env
The image serves HTTP by default; this runs it over stdio.
UNIFI_URL erforderlich env
Address of your UniFi console. For a legacy self-hosted Network application, include the port.
UNIFI_API_KEY geheim env
API key from UniFi Network → Settings → Control Plane → Integrations. Or use a username and password.
UNIFI_USERNAME env
A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.
UNIFI_PASSWORD geheim env
The local account's password, used with the username.
UNIFI_TLS_FINGERPRINT env
Recommended for an https controller with a self-signed certificate: its SHA-256 fingerprint, to pin it.
UNIFI_VERIFY_SSL env
Leave empty when you set a fingerprint. true: publicly trusted certificate. false: skip the check (insecure).
UNIFI_SITE env
The site's short name, used when a request doesn't name a site.
UNIFI_ALLOW_WRITES env
Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only.
UNIFI_ALLOW_DELETES env
Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES.
UNIFI_TOOLSETS env
Optional comma-separated list to expose fewer tools, e.g. overview,devices,clients. Empty means all.
UNIFI_AUDIT_LOG env
Set to stderr to log every change the assistant makes or previews as JSON lines. Off when empty.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto mattoddie bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Cybersicherheiti

Mehr Sterne als 0 % der anderen 1003 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 70 % der anderen 1003 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1003 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist UniFi sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: UNIFI_URL, UNIFI_API_KEY, UNIFI_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.6.1) kam vor 17 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker, MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Zeqqat, 4da MCP Server, Dependency Vulnerability Tracker — package security advisories ($0.01/query)

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Zeqqat

The safe MCP for Dokploy: agents deploy and fix apps without holding keys or seeing secrets.

von zeqqatGanz neuAktualisiert heute

Läuft in der Cloud

Installieren

4da MCP Server

Upgrade intelligence for AI agents: what an upgrade changes, where it touches your code, CVE scans.

von 4DA-SystemsGanz neu↓ 254/Wo.Aktualisiert heute

Läuft auf deinem Computer

Installieren

Dependency Vulnerability Tracker — package security advisories ($0.01/query)

Dependency vulns & malicious-package advisories. Be born in one call — free testnet funds.

von ee324Am AnfangAktualisiert heute

Läuft in der Cloud✓ a2awire.com

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

unifi-mcp

Talk to your UniFi network.

An open-source Model Context Protocol server for Ubiquiti UniFi Network. It lets Claude and other AI assistants monitor and manage your sites, devices, clients, WiFi, firewall and more, all from one Docker container.

[unifi-mcp.mattoddie.dev](https://unifi-mcp.mattoddie.dev)

Quick start · Documentation · Tool reference · Contributing

"Why is the lounge TV buffering?"

*The TV is on the Lounge AP at -78 dBm and 12 Mbps, and that AP's 5 GHz radio is at 81% channel utilisation on channel 36. Moving the AP to channel 149 or adding a wired backhaul should fix it. Want me to change the channel?*

Ask about your network in plain English. The assistant picks from 145 tools to look things up and, if you allow it, make changes. Some examples:

🩺 *"Give me a health check of the network."*
🔎 *"Which clients have a weak WiFi signal right now?"*
🔐 *"Review my firewall and port forwards for anything risky."*
🔄 *"Which devices have firmware updates, and when were they last rebooted?"*
🎟️ *"Create 10 one-day guest vouchers limited to 5 Mbps."*
🧱 *"Block the device called 'kids-tablet' until I unblock it."*

Highlights

🐳 Docker-first. There's one small distroless image (ghcr.io/mattoddie/unifi-mcp, about 22 MB) for linux/amd64 and linux/arm64. It serves Streamable HTTP for a long-running service, or stdio for docker run -i. For Claude Desktop there's also a one-click extension bundle (.mcpb) that needs no Docker.
🛡️ Safe by default. The server is read-only unless you turn on writes, and deleting configuration needs a second switch. Destructive tools are labelled so your MCP client asks before running them, and passwords and keys are redacted from output.
🔍 Preview and audit. Every write tool takes dry_run: true to show the request it would send, with a field-level diff of what would change, without changing anything. UNIFI_AUDIT_LOG records each change in a JSON Lines audit log.
🧰 Broad coverage. It covers 14 toolsets: devices, clients, switch ports and PoE, WiFi, networks and VLANs, WAN, DNS, legacy and zone-based firewall, traffic rules and routes, IDS/IPS, VPN, RADIUS, hotspot vouchers, statistics, logs, admins and backups.
🎛️ Tunable. Expose only the toolsets you need, which keeps the model's context small and focused. See Keeping the tool list small.
🔌 Works with your controller. Supports UniFi OS consoles (UDM, UDM Pro/SE, UCG, UDR, UX, Cloud Key Gen2+, UniFi OS Server) and legacy self-hosted Network applications. Auth is an API key or a local account.
🧪 Tested. The test suite runs against a mock controller on every build.

Quick start

You need Docker, a UniFi controller and an MCP client such as Claude Code.

1. Get credentials. On a UniFi OS console, create an API key: UniFi Network → Settings → Control Plane → Integrations → Create API Key. On older controllers, use a local account instead.

2. Start the server.

mkdir unifi-mcp && cd unifi-mcp

curl -fsSLO https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/compose.yaml curl -fsSL https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/example.env -o .env

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. `openssl rand -hex 32`).

For an https controller, also say how to check its certificate, or the server won't start.

Recommended: pin it with UNIFI_TLS_FINGERPRINT (see docs/security.md). example.env sets

UNIFI_VERIFY_SSL=false, which skips the check: remove it once the fingerprint is set.

docker compose up -d

3. Connect your assistant.

claude mcp add --transport http unifi http://<docker-host>:8080/mcp \

--header "Authorization: Bearer "

Now ask *"How's my network doing?"* in Claude Code.

Using Claude Desktop, VS Code, Cursor or Codex? See Connecting MCP clients. Prefer not to run a service? Use stdio mode with docker run -i.

Claude Desktop in one click

On a Mac or Windows PC with Claude Desktop, you don't need Docker at all. Download the .mcpb bundle for your computer from the latest release, open it, and enter your controller URL, API key and certificate fingerprint in the settings. See Claude Desktop.

unifi-mcp is also listed in the MCP Registry as io.github.mattoddie/unifi-mcp, with the image (over stdio) and the bundles, so clients and directories that read the registry can install it.

Turning on changes

Out of the box the assistant can look but not touch. To let it make changes, add these to .env and run docker compose up -d:

UNIFI_ALLOW_WRITES=true      # restart devices, block clients, edit WiFi/firewall/networks…

UNIFI_ALLOW_DELETES=true # also allow deleting configuration, forgetting clients… (needs writes too) UNIFI_TOOLSETS=overview,devices,clients,wifi,monitoring # optional: expose fewer tools UNIFI_AUDIT_LOG=stderr # optional: log every change (or a file path; see docs/configuration.md)

Ask for a dry run to preview a change first: *"Dry run: disable the guest WiFi. What would change?"* Read Security before turning on writes for a production network.

What it can do

Toolset	What's covered
`overview`	Sites, controller info, site health
`devices`	Device status and details, restart/locate/provision, firmware upgrades (also rolling), radios, PoE outlets, adoption, RF scans, AP groups
`clients`	Online and known clients, block/unblock, reconnect, names, fixed IPs, lock to an AP, forget
`switching`	Switch ports, port profiles, PoE power-cycling, port mirroring, link aggregation, LLDP neighbours
`wifi`	WLANs (SSIDs, security, VLANs, bands), WiFi QR codes
`networks`	Networks/VLANs and DHCP, WAN, local DNS records, bandwidth profiles, dynamic DNS
`firewall`	Port forwards, firewall rules and groups, zone-based policies and zones, traffic rules, QoS rules, NAT rules, switch ACL rules, object-oriented network policies
`routing`	Static routes, policy-based traffic routes
`security`	IDS/IPS threat management, threat log, country blocking, content filtering
`vpn`	VPN servers and site-to-site VPNs, RADIUS profiles and accounts
`hotspot`	Vouchers, hotspot operators, guest authorization, guest portal
`monitoring`	Events, alarms, traffic reports, traffic flows, DPI, speed tests, rogue APs, system log, sessions, anomalies, dashboards
`admin`	Site settings (including SNMP, mDNS and auto-backup), admins, backups, controller updates, sites
`raw`	An escape hatch that calls any controller API path

See the [tool reference](docs/tools.md) for every tool and argument. Ready-made prompts like network_health_check, troubleshoot_client and security_review chain the tools together for common jobs.

Documentation

The docs are also published at [unifi-mcp.mattoddie.dev/docs](https://unifi-mcp.mattoddie.dev/docs/), with search.


🚀 Getting started	Step-by-step setup, from credentials to first question
🔌 Connecting MCP clients	Claude Code, Claude Desktop, VS Code, Cursor, Codex, stdio mode
⚙️ Configuration	Every environment variable, Docker secrets, toolsets
🐳 Deployment	Compose, image tags, upgrades, TLS reverse proxy, hardening
💬 Using unifi-mcp	Example conversations, prompts, how saves and secrets work
🧰 Tool reference	All 145 tools and 5 prompts, generated from the code
🛡️ Security	Threat model, least privilege, safe write setups
📡 Compatibility	Supported controllers and versions, API caveats
🩹 Troubleshooting	Common errors and how to fix them
🛠️ Development	Architecture, adding a tool, testing

Contributing

Contributions are very welcome, whether that's bug reports, compatibility reports from your hardware, docs or new tools. Read the contributing guide to get started, and please follow the code of conduct. To report a vulnerability, see the security policy. Please don't open a public issue for one.

License

*unifi-mcp is an independent community project. It is not affiliated with, endorsed by or sponsored by Ubiquiti Inc. UniFi and Ubiquiti are trademarks of Ubiquiti Inc.*

UniFi

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Cybersicherheiti

Häufige Fragen

Alternativen

Zeqqat

4da MCP Server

Dependency Vulnerability Tracker — package security advisories ($0.01/query)

README vom Entwickler

unifi-mcp

Highlights

Quick start

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. openssl rand -hex 32).

For an https controller, also say how to check its certificate, or the server won't start.

Recommended: pin it with UNIFI_TLS_FINGERPRINT (see docs/security.md). example.env sets

UNIFI_VERIFY_SSL=false, which skips the check: remove it once the fingerprint is set.

Claude Desktop in one click

Turning on changes

What it can do

Documentation

Contributing

License

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. `openssl rand -hex 32`).