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

Related MCP server: UnifiyMe

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

1. 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"

2. 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

3. Instalar dependencias:

uv sync

4. 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

1. Abra Goose y vaya a Configuración » Extensiones » Agregar extensión personalizada

2. 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

1. Abra Claude y vaya a Configuración » Desarrollador » Editar configuración

2. 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"
            ]
        }
    }
}