Servidor MCP UniFi

Una implementación de servidor para gestionar y controlar dispositivos de red UniFi mediante MCP (Protocolo de Control de Gestión). Este servidor permite interacciones en lenguaje natural con su red UniFi mediante agentes de IA como Goose y Claude, integrando la API de red UniFi.

Características

Consulta sitios y dispositivos UniFi usando lenguaje natural a través de agentes de IA
Implementación de servidor local que se conecta a su aplicación de red UniFi
Compatible con Goose AI y Claude Desktop
Autenticación segura basada en clave API

Prerrequisitos

Python 3.8 o superior
administrador de paquetes uv
Aplicación de red UniFi
Clave API de UniFi (obtenida de la consola UniFi)

Configuración

Crear una clave API:
- Vaya a su consola UniFi en https://unifi.ui.com
- Vaya a Configuración » Plano de control » Integraciones
- Haga clic en "Crear clave API"
Clonar y configurar el repositorio:

git clone https://github.com/zcking/mcp-server-unifi
cd mcp-server-unifi
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

Instalar dependencias:

uv sync

Configurar variables de entorno:

export UNIFI_API_KEY="your_api_key_here"

Ejecución del servidor

Inicie el servidor de desarrollo MCP:

uv run mcp dev main.py

El inspector MCP estará disponible en http://localhost:5173 para pruebas y depuración.

Integración de agentes de IA

Configuración de Goose AI

Abra Goose y vaya a Configuración » Extensiones » Agregar extensión personalizada
Configurar la extensión:
- Identificación: unifi
- Nombre: unifi
- Descripción: Obtenga información sobre su red UniFi
- Comando: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
- Variables de entorno: Establezca UNIFI_API_KEY en su clave API

Configuración del escritorio de Claude

Abra Claude y vaya a Configuración » Desarrollador » Editar configuración
Añade a tu claude_desktop_config.json :

{
    "mcpServers": {
        "unifi": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Una implementación de servidor que permite interacciones en lenguaje natural con dispositivos de red UniFi al envolver la API de red UniFi para agentes de IA como Goose y Claude.

MCP Server UniFi