Mobile Testing und Mobile Automation KI-Agent MCP-Server

Mobile Testing, mobile Automatisierung, mobiles QA und Framework für mobile Testautomatisierung, angetrieben von KI-Agenten und MCP-Tools.

Projektübersicht: Mobile Testing, mobile Automatisierung und mobiles QA

Dieses Repository bietet ein KI-gestütztes Framework für Mobile Testing und mobile Testautomatisierung (sowie Web-Validierung) unter Verwendung von:

• Planner Agent: untersucht eine Ziel-App oder Website und generiert einen strukturierten Markdown-Testplan für mobiles QA.

• Generator Agent: konvertiert den Markdown-Testplan in ausführbare Playwright- oder Mobilewright-Tests für mobile Automatisierungs-Workflows.

• Healer Agent: führt Tests aus, erkennt Fehler und versucht automatisierte Reparaturzyklen, um die Stabilität der mobilen Testautomatisierung zu verbessern.

• Android- und iOS-Orchestratoren: führen Planner -> Generator -> Healer als End-to-End-Pipelines für jede Plattform und jeden Mobile-Testing-Lebenszyklus aus.

• MCP-Server: stellt das Framework als aufrufbare MCP-Tools über stdio für KI-Clients und Automatisierungsplattformen bereit.

Das Framework wurde entwickelt, um die Erstellung mobiler Tests zu beschleunigen, die Teststabilität zu verbessern und eine erweiterbare Basis für KI-unterstützte mobile QA-Workflows zu bieten.

Schnellstart für mobile Testautomatisierung (Ein Befehl)

Für ein schnelles, web-bereites Setup:

npm install && npx playwright install chromium

Führen Sie dann den Standard-Webtest aus:

npm run test:web

Optionales Umgebungs-Setup:

cp .env.example .env

Unter Windows PowerShell:

Copy-Item .env.example .env

Abhängigkeiten für mobile Automatisierung und mobiles QA

Erforderlich

• Node.js 18+

• npm 9+

• Playwright Chromium-Browser

Kern-NPM-Pakete

• mobilewright

• @playwright/test

• playwright

• @modelcontextprotocol/sdk

• zod

• openai

• dotenv

• fs-extra

• chalk

• axios

• cheerio

Plattform-Voraussetzungen

Web

• Keine zusätzliche Einrichtung nach der Installation der Abhängigkeiten und Chromium erforderlich.

Android

• Android SDK installiert

• ADB auf dem PATH verfügbar

• ANDROID_HOME konfiguriert

• Mindestens ein verbundenes Android-Gerät oder Emulator

Nützliche Prüfungen:

npm run doctor
npm run devices

iOS

• macOS-Host für lokale iOS-Automatisierung

• Xcode + Command Line Tools

• Gestarteter iOS-Simulator (oder kompatibler Cloud-/Mobilgeräteanbieter)

Repository-Struktur für Mobile-Testing-Projekte

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

Was jeder Bereich für Mobile Testing und Automatisierung bewirkt

• agents: KI-Agenten-Implementierungen für Planung, Generierung und Heilung in mobilen Testautomatisierungspipelines.

• mcp: stdio MCP-Server, der Planner-, Generator-, Healer- und Orchestrator-Tools bereitstellt.

• orchestrators: plattformspezifische Pipeline-Runner für Android- und iOS-mobile Automatisierung.

• tests: ausführbare Spezifikationen, einschließlich generierter Tests und kuratierter Beispiele für mobiles QA.

• plans: Markdown-Testpläne, die als Quelleneingabe für die Codegenerierung dienen.

• reports: Artefakte von Mobile-Testing- und Heilungsläufen.

Nutzungsanleitung für Mobile Testing und mobiles QA

1. Web-Testsuite ausführen

npm run test:web

2. Mobile Viewport-Projekte in Playwright ausführen (Mobile Testing)

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

3. Android- oder iOS-Mobilewright-Tests für mobile Automatisierung ausführen

npm run test:android
npm run test:ios

4. Einzelne KI-Agenten verwenden

Planner

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

Direktes CLI-Beispiel:

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

Generator

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

Direktes CLI-Beispiel:

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

Healer

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

Direktes CLI-Beispiel:

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

5. Einen neuen Test mit Android- und iOS-Agenten hinzufügen (Flow für mobile Testautomatisierung)

Verwenden Sie diesen Flow, wenn Sie Tests für eine neue Ziel-URL in Ihrem mobilen QA-Prozess erstellen möchten.

Android-Agent-Flow (Planen -> Generieren -> Ausführen -> Heilen)

1. Einen Android-Testplan generieren:

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

2. Android-Tests aus dem Plan generieren:

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

3. Den generierten Android-Test ausführen:

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

4. Fehlgeschlagene Android-Tests automatisch heilen:

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

iOS-Agent-Flow (Planen -> Generieren -> Ausführen -> Heilen)

1. Einen iOS-Testplan generieren:

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

2. iOS-Tests aus dem Plan generieren:

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

3. Den generierten iOS-Test ausführen:

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

4. Fehlgeschlagene iOS-Tests automatisch heilen:

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

Optional: Orchestratoren verwenden, anstatt jeden Schritt manuell auszuführen

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

6. Orchestrierungspipelines für mobile Automatisierung ausführen

Android-Pipeline

npm run orchestrate:android

iOS-Pipeline

npm run orchestrate:ios

7. Vollständige Web-KI-Pipeline ausführen

npm run pipeline:web

Dies führt Planner -> Generator -> Healer für Web aus.

7b. Vollständige mobile QA-Pipelines ausführen

Für End-to-End-mobile Testautomatisierung auf jeder Plattform:

npm run orchestrate:android
npm run orchestrate:ios

8. Den MCP-Server starten

npm run mcp:start

Der Server läuft auf stdio und stellt Tools bereit, darunter:

• health_check

• run_planner

• run_generator

• run_healer

• run_orchestrator

• list_repo_commands

9. MCP-Tools lokal inspizieren

npm run mcp:inspect

10. Beispiel für MCP-Client-Konfiguration

Verwenden Sie dies in einer Konfigurationsdatei für einen MCP-fähigen Client:

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

11. CI/CD-Pipeline (GitHub Actions)

Dieses Repository enthält jetzt einen CI/CD-Workflow unter .github/workflows/ci-cd.yml.

CI-Verhalten:

• Läuft bei Pushes auf main und Pull Requests, die auf main abzielen.

• Installiert Abhängigkeiten mit npm ci.

• Installiert Playwright Chromium.

• Führt die Web-Suite mit npm run test:web aus.

• Lädt Playwright-Bericht-Artefakte hoch, wenn verfügbar.

CD-Verhalten:

• Läuft nach CI bei Pushes auf main.

• Löst die Bereitstellung nur aus, wenn DEPLOY_WEBHOOK_URL als Repository-Geheimnis konfiguriert ist.

• Überspringt die Bereitstellung sicher, wenn das Geheimnis nicht gesetzt ist.

Um die Bereitstellung zu aktivieren, fügen Sie dieses Repository-Geheimnis hinzu:

• DEPLOY_WEBHOOK_URL

Beitrag zu Mobile Testing und mobiler Automatisierung

Beiträge sind willkommen. Bitte folgen Sie dem unten stehenden Workflow:

1. Forken Sie das Repository.

2. Erstellen Sie einen Feature-Branch von main.

3. Halten Sie Änderungen fokussiert und gut abgegrenzt.

4. Fügen Sie Tests für neues Verhalten hinzu oder aktualisieren Sie diese.

5. Führen Sie relevante Prüfungen durch, bevor Sie einen PR öffnen:

   • npm run test:web

   • npm run test:all

   • npm run doctor (für mobile Umgebungen)

6. Öffnen Sie einen Pull Request mit:

   • klarer Problembeschreibung

   • Implementierungszusammenfassung

   • Validierungsnachweis (Logs, Testausgabe, Screenshots, wo nützlich)

Richtlinien für Beiträge

• Bevorzugen Sie kleine, überprüfbare Pull Requests.

• Vermeiden Sie nicht zusammenhängende Refactorings im selben PR.

• Behalten Sie die Namenskonventionen für Skripte und Ordner bei.

• Dokumentieren Sie neue Befehle und Agentenverhalten in dieser README.

Danksagungen

Dieses Projekt basiert auf dem exzellenten Mobilewright-Ökosystem.

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

• Mobilewright-Dokumentation: https://mobilewright.dev

Besonderer Dank geht an die Mobilewright-Betreuer und -Mitwirkenden für die Ermöglichung praktischer mobiler Automatisierungs-Workflows für Android und iOS.

Lizenz

ISC

FAQ zum Mobile Testing (SEO)

Was ist mobile Testautomatisierung?

Mobile Testautomatisierung ist die Praxis, Tools und Skripte zu verwenden, um mobile Apps und mobile Web-Erlebnisse automatisch über Android und iOS hinweg zu validieren.

Wie hilft dieses Repository beim mobilen QA?

Dieses Projekt unterstützt mobiles QA mit KI-gesteuerter Planung, Testgenerierung und selbstheilender Ausführung sowie Android- und iOS-Orchestrierungs-Flows.

Ist dies für Teams der mobilen Automatisierung geeignet?

Ja. Es wurde für Teams entwickelt, die skalierbare mobile Automatisierung, wiederholbare Testpipelines und schnellere Feedbackzyklen für Releases benötigen.

Welche Mobile-Testing-Keywords zielt dieses Framework ab?

Dieses Framework konzentriert sich auf praktische Workflows für Mobile Testing, mobile Automatisierung, mobiles QA und mobile Testautomatisierung.

Fragen?

Wenn Sie Fragen haben:

• 💬 Öffnen Sie eine GitHub Discussion

• 🐛 Melden Sie Fehler über GitHub Issues

• 📧 E-Mail: padmaraj dot nidagundi at gmail.com

Reaktionszeit: Normalerweise 24-48 Stunden

Erstmalige Mitwirkende willkommen! 👋

Neu bei Open Source? Kein Problem! Suchen Sie nach Issues, die mit good-first-issue oder help-wanted markiert sind. Wir bieten Mentoring und Anleitung, um Ihnen zum Erfolg zu verhelfen.

Danke, dass Sie Testautomatisierung für alle besser machen! 🚀