mcp-state-machine-test-framework
v12.9.2
Published
High-fidelity State Machine MCP Server for autonomous E2E testing orchestration.
Downloads
177
Maintainers
Readme
🚀 SMS Framework: State Machine Testing V12.5
Orquestación de Pruebas E2E de Alta Fidelidad mediante Máquina de Estados Procedural (Model-Based Testing).
Este framework transforma la automatización tradicional en un sistema de orquestación autónomo y resiliente, donde la Identidad Multivectorial de los Nodos y la Verificación Técnica garantizan pruebas robustas y seguras en aplicaciones Web, Mobile e incluso APIs.
🌟 Características Principales
- 🛡️ Identidad por Huella (Fingerprinting): Los estados no son solo etiquetas; tienen una huella digital robusta basada en aserciones de identidad (
asserts) y tiempos de tolerancia (timeoutypollingInterval) que el motor valida secuencialmente tras cada transición, garantizando sincronización impecable y estabilidad en tiempo real. - ⚙️ Ejecución Híbrida (MCP + Shell): Soporte nativo y persistente para invocar cualquier servidor MCP (como
wdio-mcp) y comandos de sistema (sh:) en el ciclo de vida de la suite. - 🧙♂️ Diseño Inteligente con sms_builder: Asistente MCP interactivo integrado que guía a la IA y a los desarrolladores en el modelado de grafos, transiciones y suites de pruebas sin cometer errores de sintaxis JSON.
- 📊 Nexus Dashboard Premium: Interfaz premium interactiva (HTML + CSS glassmorphism) impulsada por
vis-networkpara auditar la topografía del mapa de estados, visualizar flujos de navegación y analizar reportes de ejecución con evidencias Base64. - ⚡ Zero-Token Execution: Costo e latencia cero durante el despliegue del test; la IA solo diseña, mientras que el motor síncrono del servidor corre la suite directamente mediante comandos nativos RPC.
🚀 Inicio Rápido
- Instalación: Instala las dependencias principales ejecutando
npm install. - Inicialización: ¡Totalmente automatizada! Al arrancar el servidor SMS, se crearán en silencio la estructura base de carpetas y las plantillas por defecto en la raíz de tu proyecto.
- Diseño del Mapa: Invoca la herramienta
sms_buildercon la acción"start"para comenzar a definir tus pantallas (Nodos) y rutas (Transiciones). Recuerda declarar al menos una aserción de identidad (sea comandosh:o herramientamcp:) en cada huella. - Casos de Uso: Añade flujos abstractos con
"add_test"y"add_route_step"inyectando datos dinámicos. - Ejecución: Lanza la automatización invocando
sms_executorespecificando tu suite y observa las evidencias en/reports/o en el Nexus Dashboard.
📁 Estructura del Proyecto
/maps/: Definiciones topográficas de la Máquina de Estados (Nodos, Huellas Digitales con aserciones, Transiciones y Variaciones Locales)./test_cases/: Casos de prueba lógicos E2E que declaran viajes abstractos (ruta_estricta+data)./suites/: Ensambladores de suites que unifican mapas y casos de prueba para ejecución con soporte de hooks./reports/: Reportes de ejecución con logs detallados, aserciones y capturas visuales.
Desarrollado para la era de la automatización autónoma y de alto rendimiento.
