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: MCP Server

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:

3. Instalar dependencias:

4. Configurar variables de entorno:

Ejecución del servidor

Inicie el servidor de desarrollo MCP:

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 :