mock-server
Servidor de mocks autoalojado basado en OpenAPI con gestión de variantes, validación de esquemas y UI integrada. Usa Node.js/Java, soporta Docker/MCP, sin registro requerido.
Ficha actualizada 27 sept 2026, 23:41 · upstream 27 sept 2026, 23:15 · release v1.3.0
Qué es mock-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este servidor permite crear respuestas mock dinámicas a partir de especificaciones OpenAPI registradas directamente desde una interfaz web integrada. Soporta múltiples estrategias de respuesta por variante (RANDOM, SEQUENTIAL, ROUND_ROBIN) y validación de esquemas en tres modos: OFF, WARN o STRICT. La arquitectura combina un backend Java Spring Boot con una UI frontend Node.js empaquetada, comunicándose a través de puertos 8080 (backend), 9090 (alternativo) y 3000 (UI).
La gestión de variantes permite definir respuestas nombradas para cada operación, con estrategias de selección que incluyen RANDOM, SEQUENTIAL, ROUND_ROBIN o DEFAULT_ONLY. El sistema valida automáticamente los cuerpos de respuesta contra el esquema OpenAPI antes de guardarlos, y valida las solicitudes entrantes en tiempo real según la configuración del modo de validación seleccionado.
Integra capacidades MCP para gestión desde asistentes de IA como Claude o Cursor, y permite interceptar tráfico hacia `/mock/{serverId}` con URLs base personalizables. Incluye visualizador de logs con scroll infinito para inspeccionar pares completos de solicitudes/respuestas por servidor mock.
- Desarrollo frontend: Mockear APIs backend sin necesidad de implementar el servicio real
- Testing CI/CD: Proveer respuestas consistentes en pipelines de integración continua
- Prototipado rápido: Validar UIs contra contratos OpenAPI antes de que el backend esté listo
- Documentación interactiva: Generar endpoints mock para demos o presentaciones técnicas
- Gestión de variantes con estrategias configurables (RANDOM, SEQUENTIAL, ROUND_ROBIN, DEFAULT_ONLY)
- Validación de esquemas OpenAPI en tres modos operativos (OFF, WARN, STRICT)
- Integración MCP nativa para control desde asistentes de IA compatibles
- UI integrada sin despliegue separado, accesible vía /ui/
- Logs de solicitud/respuesta con visualizador de scroll infinito
- Requiere Java 17+ y Node 18+ para desarrollo local
- Versión en pom.xml siempre es 1.0-SNAPSHOT (aplicada por CI al publicar)
- Validación STRICT rechaza respuestas con violaciones de esquema con código 400
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Usar Docker: `docker run -d -p 8080:8080 -v spec0-mock-data:/data ghcr.io/spec-0/mock-server`. Para desarrollo local, ejecutar backend en puerto 8080 y UI en 3000 con `make dev-backend` y `make dev-ui`. La base de datos usa H2 por defecto en `/data/spec0-mock`.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.