DevWebUI: GUI + MCP Control Plane para Servidores de Desarrollo Locales

DevWebUI es una interfaz gráfica (GUI) y plano de control en formato Model Context Protocol (MCP) para gestionar servidores de desarrollo locales. Permite iniciar, detener, reiniciar y monitorizar cada servidor desde un solo panel con métricas en tiempo real.

¿Qué es DevWebUI?

DevWebUI combina una interfaz gráfica visual con un plano de control MCP para gestionar servidores de desarrollo locales. Su propósito principal es permitir que los desarrolladores inicien, detengan y reinicien sus servicios de desarrollo desde un solo panel de control, eliminando la necesidad de mantener múltiples pestañas del terminal o usar herramientas como PM2.

La herramienta resuelve problemas comunes en el desarrollo local: no hay más necesidad de abrir decenas de pestañas con comandos repetitivos como bun run dev o npm start, ni de mantener un servidor de monitorización externo. DevWebUI centraliza todo el control en una interfaz visual, permitiendo que los agentes de IA se encarguen del despliegue y monitoreo sin necesidad de intervención manual constante.

Casos de Uso

• Iniciar y detener múltiples servicios de desarrollo desde un solo panel con estado persistente
• Monitoreo en tiempo real de CPU, memoria y logs de cada proceso individual
• Automatización de despliegue mediante agentes de IA que ejecutan comandos MCP (31 herramientas disponibles)
• Resolución automática de conflictos de puertos entre proyectos concurrentes con detección del proceso bloqueante
• Visualización de errores descriptivos deduplicados que sobreviven a reinicios y crashes
• Control de procesos con estado persistente y log de errores deduplicado para agentes AI
• Gestión de múltiples repositorios desde una única interfaz unificada

Arquitectura Técnica

Motor: Bun + Hono (HTTP + SSE) con motor MCP stdio de cero dependencias
Licencia: MIT (open source, sin restricciones comerciales)
Frontend: Vue 3 + Vite + shadcn-vue sobre Reka UI
Estilos: Tailwind v4 (temas zinc + indigo, claro/oscuro)
Puertos: localhost:4000 (API/GUI), localhost:4010 (MCP server opcional)

Instalación y Despliegue

Vía Bun (Linux/macOS/Windows WSL)

bun install
bun run dev # daemon en :4000 + GUI en http://localhost:4010

En su primer lanzamiento, DevWebUI escanea automáticamente archivos .devwebui y proyectos reconocibles. Después de eso, el escaneo inicial se desactiva a menos que lo habilites en Configuración.

Vía Windows (Precompilado)

Descarga devwebui-windows-x64.exe desde Releases. El ejecutable incluye icono, dashboard embebido y sin ventana de consola. El ZIP adyacente está reservado para actualizaciones automáticas.

Para adoptar solo releases públicos por un tiempo, configura Configuración → Actualizaciones de App → Cooldown de actualización a días: una release más joven que ese número no se ofrece ni instala, permitiendo que una release defectuosa sea detectada primero (0, el predeterminado, ofrece la release más reciente inmediatamente).

Vía macOS y Linux

Ejecuta directamente desde terminal con bun install o descarga binarios precompilados. El daemon se inicia en puerto 4000 (API) y 4010 (MCP). Para sincronizar preferencias entre máquinas, instala la librería de configuración de LunarWerx Connections (opcional).

Funciones Clave

• Control de un clic: iniciar / detener / reiniciar cualquier servidor de desarrollo con estado en vivo, CPU, memoria y logs
• Panel único por repositorio: archivo .devwebui agrupa cada proceso bajo un encabezado colapsable; proyectos auto-recargan al siguiente lanzamiento
• Lanzamientos conscientes del runtime: modo automático sigue el lockfile de cada proyecto, y comandos Bun/Node compatibles lanzan sin wrapper de shell permanente
• Rescate de conflictos de puertos: detecta puertos ocupados, indica qué proceso los mantiene y los libera con un clic
• Un origen para cada servidor: abre cualquier proceso gestionado a través del puerto de DevWebUI en http://<target>.localhost:4000 (o /proxy/<target>/), donde <target> es un ID de proceso como p1a2b3c4.web, nombre de proyecto como my-app, o puerto declarado; HTTP y WebSocket (HMR) se reenvían solo a puertos que un proceso registrado declara, detrás del mismo guardián cross-site que la API
• Log de errores persistente: stderr deduplicado / crashes / stdout con apariencia de error que sobrevive reinicios. Cada file:line:col en él es un enlace que abre esa línea en el editor que ya tienes ejecutando (VS Code y sus forks, JetBrains IDEs, Zed, Sublime Text, Notepad++); establece DEVWEBUI_EDITOR al ejecutable del editor para elegir uno explícitamente
• Atajos de escritorio (Windows): envía cualquier servidor (o todo repositorio) a tu Escritorio desde el menú ⋮; doble clic lo inicia, servidores vinculados y todo, en una ventana pequeña con botón Stop
• Diseñado para agentes: conjunto completo de herramientas MCP controla el mismo daemon que haces clic, desde un estado compartido único
• Localizado y temático: i18n completo (inglés base; añadir un idioma), tema claro/oscuro
• Vive en tu bandeja: app de bandeja Windows ejecuta el daemon oculto; Abrir / Reconstruir / Reiniciar / Salir

Seguridad

DevWebUI ejecuta local-first sin exposición a nube. Sin cuentas ni registro para funcionalidad core. Opcional: sync de preferencias requiere cuenta LunarWerx Connections.

Autenticación Local API

Por defecto, la REST API del daemon responde a cualquier llamador local que no sea una página cross-site. Inicia con DEVWEBUI_REQUIRE_AUTH=1 para requerir credencial en cada ruta /api excepto /api/health y el handshake de pairing.

Mecanismos de Seguridad

• Archivo cookie: cada arranque escribe un secreto aleatorio a .cookie en su directorio de datos (~/.devwebui, owner-only) y lo borra al salir. La CLI y el servidor MCP lo leen y envían automáticamente, sin configuración; un proceso que no puede leer tu directorio de datos es rechazado. El secreto solo se envía a una dirección loopback, incluso cuando DEVWEBUI_URL apunta a otro daemon
• Pairing de navegador: un navegador no puede leer ese archivo, así que la GUI muestra una pantalla de pairing. Haz clic en Obtener código de pairing, luego escribe el código de 6 dígitos que imprime el daemon (o que lista devwebui pairing codes). El navegador mantiene su propia clave en el local storage del origen de la GUI y la envía como header, nunca como cookie: los navegadores comparten cookies entre cada puerto localhost, así que una cookie alcanzaría a los servidores de desarrollo que abres desde el dashboard. Lista navegadores emparejados con devwebui pairing clients y revoca uno con devwebui pairing revoke <id>. Los códigos expiran después de 5 minutos. Diez intentos incorrectos (de cualquiera) bloquean el pairing por 15 minutos, así que un proceso local malcomportado puede mantener el pairing cerrado durante ese tiempo; la CLI y MCP no se ven afectados
• Token de sesión: el tray mantiene su token de sesión y sigue funcionando con reinicios/salidas

Ventajas

• Gratuito (MIT License, sin suscripciones ni límites)
• Interfaz visual única por proyecto, eliminando la necesidad de múltiples pestañas del terminal
• Soporta lanzamientos en tiempo de ejecución que respetan el lockfile y no requieren shell wrapper permanente
• Detecta conflictos de portaje entre proyectos y ofrece soluciones automáticas
• Diseñado específicamente para ser controlado por agentes de IA a través de herramientas MCP (31 tools)
• Permite personalización completa con temas (oscuro/claro) e idioma localizado
• Vive en tu bandeja sin ventana de consola molesta
• Funciona offline completamente (solo opcional: sync y ping)

Limitaciones

• No requiere cuenta de nube ni registro para la funcionalidad principal; solo es opcional el sync de preferencias entre máquinas
• El ping anónimo de instalación no registra direcciones IP, hostname o path del usuario
• La sincronización de configuración entre máquinas requiere conexión a una cuenta de LunarWerx Connections (opcional)
• No incluye soporte nativo para Docker ni contenedores como devcontainers
• Los comandos de despliegue se ejecutan directamente en el terminal sin wrapper automático
• El ping anónimo deriva y almacena ubicación gruesa (país, región, ciudad, zona horaria), ASN de red, locale y user agent truncado, pero nunca una IP

Alternativas Reales

PM2: CLI gratuito, dashboard web pagado (~$39/mes). DevWebUI es gratuito, empaquetado y añade MCP.

hotel: Browser-based, compatible con Procfile/Compose. DevWebUI añade métricas en vivo, deduplicación de errores, detección de conflictos de puertos y 31 herramientas MCP.

exo: Browser-based, compatible con Procfile/Compose. DevWebUI agrupa servidores por repositorio y envía los mismos controles sobre MCP.

FAQ

¿Es gratuito?

Sí, MIT License. Sin suscripciones ni límites.

¿Necesita cuenta/nube?

No para funcionalidad core. Opcional: sync entre máquinas.

¿Pueden controlar AI agents?

Sí, 31 tools MCP para automatización.

¿Qué es un archivo .devwebui?

Un archivo pequeño por repositorio lista los servidores a ejecutar. Déjalo en el root del repo y haz clic en Añadir proyecto. Agrupa cada proceso bajo un encabezado colapsable; proyectos auto-recargan al siguiente lanzamiento. Puedes editar la lista desde dentro de la GUI; DevWebUI escribe cambios de vuelta al archivo.

¿Maneja conflictos de puertos?

Sí. Detecta choques en un puerto, indica qué proceso lo mantiene y lo libera con un clic, sin shell requerido. Esto se sitúa junto al estado en vivo, CPU, memoria y vista de logs de cada proceso que gestiona, así que un servidor de desarrollo bloqueado es fácil de detectar sin buscar el culpable en un terminal.

¿Funciona offline?

Sí. El daemon y GUI ejecutan completamente en localhost; funcionalidad core necesita ninguna cuenta, ninguna nube y ninguna conexión a internet. Las dos únicas cosas que tocan la red son ambas opcionales: sync de configuraciones (apagado por defecto) y ping anónimo de instalación para comprobación de actualizaciones, que falla silenciosamente y se puede desactivar con DEVWEBUI_NO_PING=1.

Fuentes Verificadas

• GitHub: https://github.com/LunarWerxs/devwebui
• Sitio oficial: https://devwebui.lunarwerx.com/
• Releases: https://github.com/LunarWerxs/devwebui/releases
• PickMCP: https://pickmcp.com/servers/LunarWerxs/DevWebUI

Fecha de verificación: 2026-09-22 | Última actualización: 2026-10-05