Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Go Unifi MCP

de claytonoversión 0.3.1i★ 6iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.claytono/go-unifi-mcp

Cómo instalar

What it does

Manage UniFi sites, devices, clients, networks, port forwarding, DNS, and firewall

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Ciberseguridad

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad10/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso22/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Go Unifi MCP. Sigue https://mcp.popnx.com/i/claytono-go-unifi-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Go Unifi MCP para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "go-unifi": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/claytono/go-unifi-mcp:v0.3.1" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Go Unifi MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "go-unifi": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "ghcr.io/claytono/go-unifi-mcp:v0.3.1"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Go Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Go Unifi MCP o muestra una herramienta de Go Unifi MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Go Unifi MCP

Go Unifi MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Go Unifi MCP

  • Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Docker en tu computadora primero (una sola vez)
  • Instala Docker en tu computadora primero (una sola vez)
  • Instala Docker en tu computadora primero (una sola vez)

B · Otros en Ciberseguridad que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Go Unifi MCP para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user go-unifi -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Go Unifi MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user go-unifi -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1
  4. Escribe /mcp en Claude Code

    Deberías ver Go Unifi MCP en la lista como conectado

  5. Pruébalo

    Usa Go Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Go Unifi MCP o muestra una herramienta de Go Unifi MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Go Unifi MCP para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "go-unifi": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/claytono/go-unifi-mcp:v0.3.1" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Go Unifi MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Go Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Go Unifi MCP o muestra una herramienta de Go Unifi MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Docker en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Go Unifi MCP para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "go-unifi": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/claytono/go-unifi-mcp:v0.3.1" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Go Unifi MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Docker (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    docker --version
    • Aparece un número de versión, p. ej. Docker version … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl

    Abrir la página de descarga de Docker ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version

    Se instala una vez y sirve para todo lo que usa Docker

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Go Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Go Unifi MCP o muestra una herramienta de Go Unifi MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Go Unifi MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user go-unifi -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "go-unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/claytono/go-unifi-mcp:v0.3.1"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "go-unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/claytono/go-unifi-mcp:v0.3.1"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "go-unifi": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/claytono/go-unifi-mcp:v0.3.1"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
MPL-2.0
Conexión
Se ejecuta en tu computadora
Última versióni
0.3.1
Categoríai
Ciberseguridad
Publicado en el registroi
25 jul 2026
Último cambio de códigoi
16 nov 2026
Creador
claytono
Paquetes
oci: ghcr.io/claytono/go-unifi-mcp:v0.3.1
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub claytono, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 3 días

  • ✓ Superada

    Tiene licencia

    Usa MPL-2.0

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/claytono-go-unifi-mcp.svg)](https://mcp.popnx.com/en/servers/claytono-go-unifi-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Ciberseguridadi

  • Más estrellas que el 90% de los otros 1117 servidores de esta categoría
  • Publicado en el registro más recientemente que el 24% de los otros 1117 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1117 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Go Unifi MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 3 días, y la última versión (0.3.1) llegó al registro hace 4 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

GitHits

Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.

de githits-comEn crecimiento↓ 3,8 mil/sem★ 138Actualizado hoy

Computadora o nube✓ del servicio · githits.com

Snyk MCP

Easily find and fix security issues in your applications leveraging Snyk platform capabilities.

de snykMuy usado↓ 762,1 mil/sem★ 61Actualizado hace 7 meses

Se ejecuta en tu computadora✓ del servicio · snyk.io

TokenSafe

Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.

de tokensafe-devMuy usado↓ 6,8 mil/sem★ 47Actualizado hoy

Computadora o nube✓ del servicio · tokensafe.dev

Draugr

Security scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.

de draugr-devInicial★ 30Actualizado anteayer

Se ejecuta en tu computadora✓ del servicio · draugr.dev
Comparado con otros parecidos
Este
Go Unifi MCP
GitHitsDependency Management MCP ServerSnyk MCPTokenSafeDraugr
Dónde se ejecutaSe instala en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoEn la nube o instalado en tu equipoSe instala en tu equipo
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/35/53/43/35/53/3
LicenciaMPL-2.0Apache-2.0–Apache-2.0MITApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

go-unifi-mcp

A Model Context Protocol (MCP) server for UniFi Network Controller, written in Go.

Overview

go-unifi-mcp provides an MCP interface to UniFi Network Controller, enabling AI assistants and other MCP clients to interact with your UniFi infrastructure.

Why this exists

I couldn’t find an MCP server that supported both v1 and v2 firewall rules and IPv6, so I built one. This wraps the go-unifi library (which I trust from my Terraform provider experience) and leans on its generated API surface. The server is generated from the controller’s own API definitions, which makes it much easier to keep tool coverage up to date as UniFi evolves.

UniFi controller versioning

This project generates tools against the same UniFi Controller version pinned by go-unifi. When go-unifi updates its supported controller version, we regenerate our field definitions and tool metadata to match. We support the same controller range; see their controller support range.

Installation

Binary (GitHub Releases)

Download pre-built binaries from the Releases page. Binaries are available for macOS and Linux (amd64/arm64).

# macOS (Apple Silicon)

curl -L https://github.com/claytono/go-unifi-mcp/releases/latest/download/go-unifi-mcp_darwin_arm64.tar.gz | tar xz sudo mv go-unifi-mcp /usr/local/bin/

macOS (Intel)

curl -L https://github.com/claytono/go-unifi-mcp/releases/latest/download/go-unifi-mcp_darwin_amd64.tar.gz | tar xz sudo mv go-unifi-mcp /usr/local/bin/

Linux (amd64)

curl -L https://github.com/claytono/go-unifi-mcp/releases/latest/download/go-unifi-mcp_linux_amd64.tar.gz | tar xz sudo mv go-unifi-mcp /usr/local/bin/

Linux (arm64)

curl -L https://github.com/claytono/go-unifi-mcp/releases/latest/download/go-unifi-mcp_linux_arm64.tar.gz | tar xz sudo mv go-unifi-mcp /usr/local/bin/

Homebrew

Available from the claytono/homebrew-tap tap:

brew install claytono/tap/go-unifi-mcp
Nix
# Run without installing

nix run github:claytono/go-unifi-mcp

Install to your profile

nix profile install github:claytono/go-unifi-mcp

Docker

Multi-architecture images (amd64/arm64) are published to GitHub Container Registry.

# Latest (pinned to most recent release, rebuilt on base image updates)

docker pull ghcr.io/claytono/go-unifi-mcp:latest

Edge (built from main on every merge, unstable)

docker pull ghcr.io/claytono/go-unifi-mcp:edge

Go Install
go install github.com/claytono/go-unifi-mcp/cmd/go-unifi-mcp@latest

Configuration

UniFi Credentials

The server requires access to a UniFi Network Controller. Two authentication methods are supported:

  1. API Key (preferred): Create an API key in your UniFi controller under Settings > Control Plane > Integrations. Set UNIFI_HOST and UNIFI_API_KEY.
  1. Username/Password: Use a local admin account. Set UNIFI_HOST, UNIFI_USERNAME, and UNIFI_PASSWORD.
Claude Desktop

Add to your claude_desktop_config.json:

Using the binary:

{

"mcpServers": { "unifi": { "command": "/usr/local/bin/go-unifi-mcp", "env": { "UNIFI_HOST": "https://your-controller:443", "UNIFI_API_KEY": "your-api-key" } } } }

Using Docker:

{

"mcpServers": { "unifi": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "UNIFI_HOST", "-e", "UNIFI_API_KEY", "ghcr.io/claytono/go-unifi-mcp:latest" ], "env": { "UNIFI_HOST": "https://your-controller:443", "UNIFI_API_KEY": "your-api-key" } } } }

Claude Code
claude mcp add unifi -- go-unifi-mcp

Then set the required environment variables in your shell before running claude.

Environment Variables
VariableRequiredDefaultDescription
UNIFI_HOSTYes—UniFi controller URL
UNIFI_API_KEY\*—API key (preferred auth method)
UNIFI_USERNAME\*—Username for password auth
UNIFI_PASSWORD\*—Password for password auth
UNIFI_SITENodefaultUniFi site name
UNIFI_VERIFY_SSLNotrueWhether to verify SSL certs
UNIFI_LOG_LEVELNoerrorgo-unifi client log level
UNIFI_TOOL_MODENolazyTool registration mode

\* Either UNIFI_API_KEY or both UNIFI_USERNAME and UNIFI_PASSWORD must be set.

Log Levels

The UNIFI_LOG_LEVEL variable controls logging from the underlying go-unifi client library. The default is error because the client otherwise emits INFO messages to stderr, which can interfere with tools like mcp-cli that parse JSON on stdout/stderr.

LevelDescription
disabledNo logging
traceMost verbose, including wire details
debugDebug messages
infoInformational messages
warnWarnings only
errorErrors only (default)
Tool Modes

The server supports two tool registration modes, following the pattern established by unifi-network-mcp:

ModeToolsContext SizeDescription
lazy3~200 tokensMeta-tools only (default, recommended for LLMs)
eager252~55K tokensAll tools registered directly

Lazy mode (default) registers only 3 meta-tools that provide access to 252 UniFi operations (generated from the controller API):

  • tool_index - Search/filter the tool catalog by category or resource
  • execute - Execute any tool by name with arguments
  • batch - Execute multiple tools in parallel

This dramatically reduces context window usage while preserving full functionality. The LLM first queries the index to find relevant tools, then executes them via the dispatcher.

Eager mode registers all 252 tools directly, which may be useful for non-LLM clients or debugging but consumes significant context.

Update semantics: Updates use a read-modify-write flow against the controller API. We fetch the current resource, merge your fields, and submit the full object. This avoids clearing unspecified fields, but it is not atomic and concurrent updates can race (last write wins) because the UniFi API does not expose etags or revision IDs. In practice this is unlikely to be an issue, but it's something to be aware of.

ID Resolution

Responses from the UniFi API contain opaque ID references (e.g. network_id, usergroup_id, networkconf_id). By default, the server resolves these to human-readable names by looking up the referenced resource and injecting a sibling _name field:

{

"src_networkconf_id": "609fbf24e3ae433962e000de", "src_networkconf_name": "IOT" }

Resolution uses a per-request cache, so listing 100 firewall rules that reference networks only makes one additional ListNetwork API call. Typical overhead is 10-40ms depending on how many distinct resource types are referenced.

To disable resolution for a specific call, pass "resolve": false in the tool arguments.

Query Parameters

All list operations support optional post-processing parameters for filtering and projecting results.

filter — Match items by field values. Supports three operators:

// Exact match

{"filter": {"type": "usw"}}

// Substring match (case-insensitive) {"filter": {"name": {"contains": "office"}}}

// Regular expression (RE2 syntax: https://github.com/google/re2/wiki/Syntax) {"filter": {"name": {"regex": "^ap-.*"}}}

// Multiple conditions (ANDed together) {"filter": {"type": "uap", "name": {"contains": "echo"}}}

search — Case-insensitive full-text search across all string field values:

{ "search": "living room" }

fields — Project the response to include only specific keys:

{ "fields": ["name", "ip", "mac"] }

Parameters can be combined. Execution order is filter → search → fields, so you can filter on fields that are excluded from the output:

{

"filter": { "type": "uap" }, "search": "echo", "fields": ["name", "ip"] }

Development

Prerequisites
  • Nix with flakes enabled
  • direnv (optional but recommended)
Developing
# Clone the repository

git clone https://github.com/claytono/go-unifi-mcp.git cd go-unifi-mcp

Enter the development environment

nix develop

Or with direnv:

direnv allow

Install pre-commit hooks

pre-commit install

Run linters

task lint

Run tests

task test

Run tests with coverage

task coverage

Available Tasks
task lint        # Run linters via pre-commit

task test # Run tests task coverage # Run tests with coverage checks task build # Build the binary task generate # Run go generate

Testing with mcp-cli

The development environment includes mcp-cli for interactive testing of the MCP server.

  1. Create .envrc.local with your UniFi credentials (not tracked in git):
   export UNIFI_HOST="https://your-controller:443"

export UNIFI_API_KEY="your-api-key"

Or use username/password:

export UNIFI_USERNAME="admin"

export UNIFI_PASSWORD="password"

  1. Build the binary:
   task build
  1. Test with mcp-cli:

The .mcp_servers.json config provides two server entries:

  • go-unifi-mcp - eager mode (252 tools)
  • go-unifi-mcp-lazy - lazy mode (3 meta-tools)

Eager mode (direct tool access):

   # List tools (shows all 252)

mcp-cli info go-unifi-mcp

Call a tool directly

mcp-cli call go-unifi-mcp list_device '{}' mcp-cli call go-unifi-mcp list_network '{"site": "default"}'

Lazy mode (meta-tools):

   # List tools (shows only 3 meta-tools)

mcp-cli info go-unifi-mcp-lazy

Query the tool index

mcp-cli call go-unifi-mcp-lazy tool_index '{}' mcp-cli call go-unifi-mcp-lazy tool_index '{"category": "list"}' mcp-cli call go-unifi-mcp-lazy tool_index '{"resource": "network"}'

Execute a tool via the dispatcher

mcp-cli call go-unifi-mcp-lazy execute '{"tool": "list_device", "arguments": {}}'

Batch execute multiple tools

mcp-cli call go-unifi-mcp-lazy batch '{"calls": [{"tool": "list_network", "arguments": {}}, {"tool": "list_device", "arguments": {}}]}'

Credits

This project builds upon:

  • go-unifi - Go client library for UniFi Network Controller
  • unifi-network-mcp - Python MCP server for UniFi that inspired this project
  • mcp-go - Go SDK for Model Context Protocol

License

MPL-2.0