omada-mcp
Servidor MCP para TP-Link Omada SDN con 78 herramientas CRUD completas para redes, dispositivos, clientes, VLANs, firewall, Wi-Fi y puertos de switch. Soporta autenticación OAuth y web session.
Ficha actualizada 25 sept 2026, 1:46 · upstream 25 sept 2026, 1:34 · release v0.6.0
Qué es omada-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Omada MCP es un servidor Model Context Protocol diseñado específicamente para interactuar con controladores TP-Link Omada SDN. Proporciona acceso completo a la configuración de red mediante 78 herramientas de lectura y escritura, cubriendo sitios, gateways, switches, puntos de acceso, clientes, VLANs, firewall, Wi-Fi, enrutamiento y WAN.
El servidor combina dos superficies de API: la oficial Open API de Omada y la API interna del controlador web UI para funcionalidades no expuestas por la Open API (ACLs, rutas, port forwarding en OC200). Soporta tres modos de autenticación: OAuth client credentials, autenticación de sesión web Fusion gateway, y credenciales opcionales de interfaz web.
Incluye características de seguridad por diseño con anotaciones destructiveHint en herramientas de escritura, rechazo de campos desconocidos en lugar de silenciarlos, y soporte para dry runs en operaciones de mayor riesgo como setApRadio y setLogNotifications. También incluye un proceso companion opcional para WAN failover guard que corrige problemas de Link Backup.
- Diagnóstico y optimización de redes Wi-Fi mediante análisis de actividad de clientes, canales de radio y estadísticas de reintentos
- Automatización de despliegue de VLANs y perfiles LAN para segmentación de red en entornos empresariales
- Configuración dinámica de reglas de firewall ACLs y port forwarding sin intervención manual del controlador
- Monitoreo continuo de estado WAN con failover automático cuando el módem entrega leases privados
- Gestión remota de dispositivos Omada mediante acciones como reboot, adoptDevice y bloquear/desbloquear clientes
- 78 herramientas CRUD completas para configuración de red Omada incluyendo operaciones en batch para puertos de switch
- Seguridad por diseño con dry runs en operaciones destructivas y verificación automática al leer cambios aplicados
- Soporte dual API: Open API oficial más API interna web UI para funcionalidades no expuestas públicamente
- Tres modos de autenticación flexibles: OAuth, web session Fusion gateway y credenciales web UI opcionales
- Transportes HTTP streamable y SSE con health checks, CORS y soporte opcional para ngrok tunnelling
- Proceso companion WAN failover guard que corrige fallos conocidos en Link Backup de Omada
- Requiere controlador Omada con Open API habilitado o Fusion gateway sin OAuth nativo
- Algunas herramientas requieren credenciales web UI adicionales para funcionalidades avanzadas como ACLs y rutas estáticas
- Herramienta setApRadio puede desconectar clientes en la banda afectada durante cambios de configuración
- Sin soporte para Docker Compose, solo Dockerfile individual o ejecución desde fuente
- Algunas funciones IDS/IPS reportan supported: false en modelos de gateway sin capacidades IDS/IPS
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado ejecutar vía Docker con ghcr.io/realtydev/omada-mcp:latest. Configurar OMADA_BASE_URL al endpoint del controlador, OMADA_CLIENT_ID y OMADA_CLIENT_SECRET para OAuth, o OMADA_WEB_USERNAME/OMADA_WEB_PASSWORD para Fusion gateways. Para HTTP transport, activar MCP_SERVER_USE_HTTP=true y exponer puerto 3000. Usar OMADA_STRICT_SSL=false en entornos con certificados auto-firmados. Verificar compatibilidad de versión del controlador Omada antes de operaciones destructivas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.