Servidor MCP de Agente de IA para Pruebas y Automatización Móvil

Pruebas móviles, automatización móvil, control de calidad (QA) móvil y marco de automatización de pruebas móviles impulsado por agentes de IA y herramientas MCP.

Descripción general del proyecto: Pruebas móviles, automatización móvil y QA móvil

Este repositorio proporciona un marco impulsado por IA para pruebas móviles y automatización de pruebas móviles (además de validación web) utilizando:

• Agente planificador: explora una aplicación o sitio objetivo y genera un plan de pruebas en Markdown estructurado para QA móvil.

• Agente generador: convierte el plan de pruebas en Markdown en pruebas ejecutables de Playwright o Mobilewright para flujos de trabajo de automatización móvil.

• Agente sanador: ejecuta pruebas, detecta fallos e intenta ciclos de reparación automatizados para mejorar la estabilidad de la automatización de pruebas móviles.

• Orquestadores de Android e iOS: ejecutan Planificador -> Generador -> Sanador como tuberías de extremo a extremo para cada plataforma y ciclo de vida de pruebas móviles.

• Servidor MCP: expone el marco como herramientas MCP invocables a través de stdio para clientes de IA y plataformas de automatización.

El marco está diseñado para acelerar la creación de pruebas móviles, mejorar la estabilidad de las pruebas y proporcionar una base extensible para flujos de trabajo de QA móvil asistidos por IA.

Configuración rápida para la automatización de pruebas móviles (un comando)

Para una configuración rápida lista para la web:

npm install && npx playwright install chromium

Luego ejecute la prueba web predeterminada:

npm run test:web

Configuración de entorno opcional:

cp .env.example .env

En Windows PowerShell:

Copy-Item .env.example .env

Dependencias para la automatización móvil y QA móvil

Requerido

• Node.js 18+

• npm 9+

• Navegador Playwright Chromium

Paquetes NPM principales

• mobilewright

• @playwright/test

• playwright

• @modelcontextprotocol/sdk

• zod

• openai

• dotenv

• fs-extra

• chalk

• axios

• cheerio

Requisitos previos de la plataforma

Web

• No se requiere configuración adicional después de instalar las dependencias y Chromium.

Android

• Android SDK instalado

• ADB disponible en PATH

• ANDROID_HOME configurado

• Al menos un dispositivo Android o emulador conectado

Comprobaciones útiles:

npm run doctor
npm run devices

iOS

• Host macOS para automatización local de iOS

• Xcode + Command Line Tools

• Simulador de iOS iniciado (o proveedor de dispositivos móviles/nube compatible)

Estructura del repositorio para proyectos de pruebas móviles

Mobile-App-Testing-AI-Agent-MCP-Server/
├── agents/
│   ├── planner.js
│   ├── generator.js
│   └── healer.js
├── mcp/
│   └── server.js
├── orchestrators/
│   ├── android-orchestrator.js
│   └── ios-orchestrator.js
├── tests/
│   ├── generated/
│   └── uselessweb/
│       ├── uselessweb.spec.js
│       ├── uselessweb-android.test.js
│       └── uselessweb-ios.test.js
├── plans/
│   └── uselessweb-org--web-test-plan.md
├── reports/
├── mobilewright.config.js
├── playwright.config.js
├── .env.example
└── package.json

Qué hace cada área para las pruebas y la automatización móvil

• agents: implementaciones de agentes de IA para planificación, generación y sanación en tuberías de automatización de pruebas móviles.

• mcp: servidor MCP stdio que expone herramientas de planificador, generador, sanador y orquestador.

• orchestrators: ejecutores de tuberías específicos de la plataforma para la automatización móvil de Android e iOS.

• tests: especificaciones ejecutables, incluidas pruebas generadas y ejemplos seleccionados para QA móvil.

• plans: planes de prueba en Markdown utilizados como entrada de origen para la generación de código.

• reports: artefactos de ejecución de pruebas y sanación móvil.

Guía de uso para pruebas móviles y QA móvil

1. Ejecutar suite de pruebas web

npm run test:web

2. Ejecutar proyectos de viewport móvil en Playwright (pruebas móviles)

npm run test:mobile-chrome
npm run test:mobile-safari

3. Ejecutar pruebas de Mobilewright para Android o iOS para automatización móvil

npm run test:android
npm run test:ios

4. Usar agentes de IA individuales

Planificador

npm run agent:planner
npm run agent:planner:android
npm run agent:planner:ios

Ejemplo de CLI directo:

node agents/planner.js --url=https://uselessweb.org/ --platform=web --out=plans/

Generador

npm run agent:generator
npm run agent:generator:android
npm run agent:generator:ios

Ejemplo de CLI directo:

node agents/generator.js --plan=plans/uselessweb-org--web-test-plan.md --platform=web --out=tests/generated/

Sanador

npm run agent:healer
npm run agent:healer:android
npm run agent:healer:ios

Ejemplo de CLI directo:

node agents/healer.js --spec=tests/uselessweb/uselessweb.spec.js --platform=web --retries=3

5. Agregar una nueva prueba con agentes de Android e iOS (flujo de automatización de pruebas móviles)

Utilice este flujo cuando desee crear pruebas para una nueva URL objetivo en su proceso de QA móvil.

Flujo del agente de Android (planificar -> generar -> ejecutar -> sanar)

1. Generar un plan de pruebas de Android:

node agents/planner.js --url=https://uselessweb.org --platform=android --out=plans/

2. Generar pruebas de Android a partir del plan:

node agents/generator.js --plan=plans/example-com-android-test-plan.md --platform=android --out=tests/generated/

3. Ejecutar la prueba de Android generada:

npx mobilewright test tests/generated/example-com-android-test-plan.test.js

4. Autorreparar pruebas de Android fallidas:

node agents/healer.js --spec=tests/generated/example-com-android-test-plan.test.js --platform=android --retries=3

Flujo del agente de iOS (planificar -> generar -> ejecutar -> sanar)

1. Generar un plan de pruebas de iOS:

node agents/planner.js --url=https://uselessweb.org --platform=ios --out=plans/

2. Generar pruebas de iOS a partir del plan:

node agents/generator.js --plan=plans/example-com-ios-test-plan.md --platform=ios --out=tests/generated/

3. Ejecutar la prueba de iOS generada:

npx mobilewright test tests/generated/example-com-ios-test-plan.test.js

4. Autorreparar pruebas de iOS fallidas:

node agents/healer.js --spec=tests/generated/example-com-ios-test-plan.test.js --platform=ios --retries=3

Opcional: usar orquestadores en lugar de ejecutar cada paso manualmente

npm run orchestrate:android -- --url=https://uselessweb.org --retries=3
npm run orchestrate:ios -- --url=https://uselessweb.org --retries=3

6. Ejecutar tuberías de orquestación para automatización móvil

Tubería de Android

npm run orchestrate:android

Tubería de iOS

npm run orchestrate:ios

7. Ejecutar tubería completa de IA web

npm run pipeline:web

Esto ejecuta Planificador -> Generador -> Sanador para la web.

7b. Ejecutar tuberías completas de QA móvil

Para la automatización de pruebas móviles de extremo a extremo en cada plataforma:

npm run orchestrate:android
npm run orchestrate:ios

8. Iniciar el servidor MCP

npm run mcp:start

El servidor se ejecuta en stdio y expone herramientas que incluyen:

• health_check

• run_planner

• run_generator

• run_healer

• run_orchestrator

• list_repo_commands

9. Inspeccionar herramientas MCP localmente

npm run mcp:inspect

10. Ejemplo de configuración de cliente MCP

Úselo en un archivo de configuración de cliente compatible con MCP:

{
   "mcpServers": {
      "mobile-testing-ai-agent": {
         "command": "node",
         "args": ["mcp/server.js"],
         "cwd": "."
      }
   }
}

11. Tubería CI/CD (GitHub Actions)

Este repositorio ahora incluye un flujo de trabajo CI/CD en .github/workflows/ci-cd.yml.

Comportamiento de CI:

• Se ejecuta en pushes a main y pull requests dirigidos a main.

• Instala dependencias con npm ci.

• Instala Playwright Chromium.

• Ejecuta la suite web con npm run test:web.

• Sube artefactos de informe de Playwright cuando están disponibles.

Comportamiento de CD:

• Se ejecuta después de CI en pushes a main.

• Activa la implementación solo si DEPLOY_WEBHOOK_URL está configurado como un secreto del repositorio.

• Omite de forma segura la implementación cuando el secreto no está configurado.

Para habilitar la implementación, agregue este secreto del repositorio:

• DEPLOY_WEBHOOK_URL

Contribuir a las pruebas móviles y la automatización móvil

Las contribuciones son bienvenidas. Por favor, siga el flujo de trabajo a continuación:

1. Haga un fork del repositorio.

2. Cree una rama de características desde main.

3. Mantenga los cambios enfocados y bien definidos.

4. Agregue o actualice pruebas para el nuevo comportamiento.

5. Ejecute las comprobaciones relevantes antes de abrir un PR:

   • npm run test:web

   • npm run test:all

   • npm run doctor (para entornos móviles)

6. Abra un pull request con:

   • declaración clara del problema

   • resumen de la implementación

   • evidencia de validación (registros, salida de prueba, capturas de pantalla donde sea útil)

Pautas de contribución

• Prefiera pull requests pequeños y revisables.

• Evite refactorizaciones no relacionadas en el mismo PR.

• Preserve las convenciones de nomenclatura de scripts y carpetas.

• Documente los nuevos comandos y comportamientos de los agentes en este README.

Agradecimientos

Este proyecto se basa en el excelente ecosistema Mobilewright.

• Marco Mobilewright: https://github.com/mobile-next/mobilewright

• Documentación de Mobilewright: https://mobilewright.dev

Un agradecimiento especial a los mantenedores y colaboradores de Mobilewright por permitir flujos de trabajo de automatización móvil prácticos en Android e iOS.

Licencia

ISC

Preguntas frecuentes sobre pruebas móviles (SEO)

¿Qué es la automatización de pruebas móviles?

La automatización de pruebas móviles es la práctica de utilizar herramientas y scripts para validar aplicaciones móviles y experiencias web móviles automáticamente en Android e iOS.

¿Cómo ayuda este repositorio con el QA móvil?

Este proyecto admite el QA móvil con planificación impulsada por IA, generación de pruebas y ejecución de autorreparación, además de flujos de orquestación de Android e iOS.

¿Es esto adecuado para equipos de automatización móvil?

Sí. Está diseñado para equipos que necesitan automatización móvil escalable, tuberías de prueba repetibles y ciclos de retroalimentación más rápidos para las versiones.

¿A qué palabras clave de pruebas móviles apunta este marco?

Este marco se centra en flujos de trabajo prácticos para pruebas móviles, automatización móvil, QA móvil y automatización de pruebas móviles.

¿Preguntas?

Si tiene alguna pregunta:

• 💬 Abra una Discusión de GitHub

• 🐛 Informe errores a través de Issues de GitHub

• 📧 Correo electrónico: padmaraj punto nidagundi arroba gmail punto com

Tiempo de respuesta: Normalmente 24-48 horas

¡Bienvenidos los colaboradores primerizos! 👋

¿Nuevo en el código abierto? ¡No hay problema! Busque problemas etiquetados con good-first-issue o help-wanted. Brindamos tutoría y orientación para ayudarlo a tener éxito.

¡Gracias por hacer que la automatización de pruebas sea mejor para todos! 🚀