モバイルテストおよびモバイル自動化AIエージェントMCPサーバー

AIエージェントとMCPツールを活用した、モバイルテスト、モバイル自動化、モバイルQA、およびモバイルテスト自動化フレームワーク。

プロジェクト概要: モバイルテスト、モバイル自動化、およびモバイルQA

このリポジトリは、以下を使用してモバイルテストおよびモバイルテスト自動化（Web検証を含む）を行うためのAI駆動フレームワークを提供します：

• プランナーエージェント: 対象のアプリやサイトを探索し、モバイルQA用の構造化されたMarkdownテスト計画を生成します。

• ジェネレーターエージェント: Markdownテスト計画を、モバイル自動化ワークフロー用の実行可能なPlaywrightまたはMobilewrightテストに変換します。

• ヒーラーエージェント: テストを実行し、失敗を検出し、モバイルテスト自動化の安定性を向上させるために自動修復サイクルを試みます。

• AndroidおよびiOSオーケストレーター: 各プラットフォームおよびモバイルテストライフサイクル向けに、プランナー -> ジェネレーター -> ヒーラーをエンドツーエンドのパイプラインとして実行します。

• MCPサーバー: フレームワークをstdio経由で呼び出し可能なMCPツールとして、AIクライアントや自動化プラットフォームに公開します。

このフレームワークは、モバイルテストの作成を加速し、テストの安定性を向上させ、AI支援によるモバイルQAワークフローのための拡張可能なベースラインを提供するために設計されています。

モバイルテスト自動化のためのクイックセットアップ（1コマンド）

Web対応の高速セットアップ:

npm install && npx playwright install chromium

次に、デフォルトのWebテストを実行します:

npm run test:web

オプションの環境セットアップ:

cp .env.example .env

Windows PowerShellの場合:

Copy-Item .env.example .env

モバイル自動化およびモバイルQAの依存関係

必須

• Node.js 18+

• npm 9+

• Playwright Chromiumブラウザ

コアNPMパッケージ

• mobilewright

• @playwright/test

• playwright

• @modelcontextprotocol/sdk

• zod

• openai

• dotenv

• fs-extra

• chalk

• axios

• cheerio

プラットフォームの前提条件

Web

• 依存関係とChromiumをインストールした後は、追加のセットアップは不要です。

Android

• Android SDKがインストールされていること

• ADBがPATHに含まれていること

• ANDROID_HOMEが設定されていること

• 少なくとも1つの接続されたAndroidデバイスまたはエミュレータがあること

便利なチェック:

npm run doctor
npm run devices

iOS

• ローカルiOS自動化のためのmacOSホスト

• Xcode + Command Line Tools

• 起動中のiOSシミュレータ（または互換性のあるクラウド/モバイルデバイスプロバイダー）

モバイルテストプロジェクトのレポジトリ構造

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

各領域のモバイルテストおよび自動化における役割

• agents: モバイルテスト自動化パイプラインにおける計画、生成、修復のためのAIエージェント実装。

• mcp: プランナー、ジェネレーター、ヒーラー、オーケストレーターツールを公開するstdio MCPサーバー。

• orchestrators: AndroidおよびiOSモバイル自動化のためのプラットフォーム固有のパイプラインランナー。

• tests: 生成されたテストやモバイルQA用のキュレーションされた例を含む、実行可能な仕様。

• plans: コード生成のソース入力として使用されるMarkdownテスト計画。

• reports: モバイルテストおよび修復の実行成果物。

モバイルテストおよびモバイルQAの利用ガイド

1. Webテストスイートの実行

npm run test:web

2. Playwrightでのモバイルビューポートプロジェクトの実行（モバイルテスト）

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

3. モバイル自動化のためのAndroidまたはiOS Mobilewrightテストの実行

npm run test:android
npm run test:ios

4. 個別のAIエージェントの使用

プランナー

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

直接CLIの例:

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

ジェネレーター

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

直接CLIの例:

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

ヒーラー

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

直接CLIの例:

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

5. AndroidおよびiOSエージェントを使用した新しいテストの追加（モバイルテスト自動化フロー）

モバイルQAプロセスで新しいターゲットURLのテストを作成したい場合に、このフローを使用します。

Androidエージェントフロー（計画 -> 生成 -> 実行 -> 修復）

1. Androidテスト計画を生成:

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

2. 計画からAndroidテストを生成:

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

3. 生成されたAndroidテストを実行:

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

4. 失敗したAndroidテストを自動修復:

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

iOSエージェントフロー（計画 -> 生成 -> 実行 -> 修復）

1. iOSテスト計画を生成:

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

2. 計画からiOSテストを生成:

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

3. 生成されたiOSテストを実行:

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

4. 失敗したiOSテストを自動修復:

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

オプション: 各ステップを手動で実行する代わりにオーケストレーターを使用する

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

6. モバイル自動化のためのオーケストレーションパイプラインの実行

Androidパイプライン

npm run orchestrate:android

iOSパイプライン

npm run orchestrate:ios

7. 完全なWeb AIパイプラインの実行

npm run pipeline:web

これはWeb向けにプランナー -> ジェネレーター -> ヒーラーを実行します。

7b. 完全なモバイルQAパイプラインの実行

各プラットフォームでのエンドツーエンドのモバイルテスト自動化向け:

npm run orchestrate:android
npm run orchestrate:ios

8. MCPサーバーの起動

npm run mcp:start

サーバーはstdio上で実行され、以下を含むツールを公開します:

• health_check

• run_planner

• run_generator

• run_healer

• run_orchestrator

• list_repo_commands

9. ローカルでのMCPツールの検査

npm run mcp:inspect

10. MCPクライアント設定の例

MCP対応クライアントの設定ファイルでこれを使用します:

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

11. CI/CDパイプライン（GitHub Actions）

このリポジトリには、.github/workflows/ci-cd.ymlにCI/CDワークフローが含まれています。

CIの動作:

• mainへのプッシュおよびmainをターゲットとするプルリクエストで実行されます。

• npm ciで依存関係をインストールします。

• Playwright Chromiumをインストールします。

• npm run test:webでWebスイートを実行します。

• 利用可能な場合にPlaywrightレポートの成果物をアップロードします。

CDの動作:

• mainへのプッシュ時にCIの後に実行されます。

• DEPLOY_WEBHOOK_URLがリポジトリシークレットとして設定されている場合にのみデプロイをトリガーします。

• シークレットが設定されていない場合は、安全にデプロイをスキップします。

デプロイを有効にするには、このリポジトリシークレットを追加してください:

• DEPLOY_WEBHOOK_URL

モバイルテストおよびモバイル自動化への貢献

貢献を歓迎します。以下のワークフローに従ってください:

1. リポジトリをフォークします。

2. mainからフィーチャーブランチを作成します。

3. 変更は焦点を絞り、範囲を限定してください。

4. 新しい動作のためにテストを追加または更新してください。

5. PRを開く前に、関連するチェックを実行してください:

   • npm run test:web

   • npm run test:all

   • npm run doctor (モバイル環境用)

6. 以下を添えてプルリクエストを開いてください:

   • 明確な問題の記述

   • 実装の概要

   • 検証の証拠（ログ、テスト出力、有用な場合はスクリーンショット）

貢献ガイドライン

• 小さく、レビュー可能なプルリクエストを優先してください。

• 同じPR内で無関係なリファクタリングを避けてください。

• スクリプトとフォルダの命名規則を維持してください。

• 新しいコマンドとエージェントの動作をこのREADMEに文書化してください。

謝辞

このプロジェクトは、優れたMobilewrightエコシステムの上に構築されています。

• Mobilewrightフレームワーク: https://github.com/mobile-next/mobilewright

• Mobilewrightドキュメント: https://mobilewright.dev

AndroidおよびiOS全体で実用的なモバイル自動化ワークフローを可能にしてくれたMobilewrightのメンテナーと貢献者に感謝します。

ライセンス

ISC

モバイルテストFAQ（SEO）

モバイルテスト自動化とは何ですか？

モバイルテスト自動化は、ツールやスクリプトを使用して、AndroidおよびiOS全体でモバイルアプリやモバイルWebエクスペリエンスを自動的に検証する手法です。

このリポジトリはモバイルQAにどのように役立ちますか？

このプロジェクトは、AI駆動の計画、テスト生成、自己修復実行、およびAndroidとiOSのオーケストレーションフローにより、モバイルQAをサポートします。

モバイル自動化チームに適していますか？

はい。スケーラブルなモバイル自動化、反復可能なテストパイプライン、およびリリースに向けたより迅速なフィードバックサイクルを必要とするチーム向けに構築されています。

このフレームワークはどのモバイルテストキーワードをターゲットにしていますか？

このフレームワークは、モバイルテスト、モバイル自動化、モバイルQA、およびモバイルテスト自動化の実用的なワークフローに焦点を当てています。

質問がありますか？

質問がある場合:

• 💬 GitHub Discussionを開く

• 🐛 GitHub Issues経由でバグを報告する

• 📧 メール: padmaraj dot nidagundi at gmail.com

応答時間: 通常24〜48時間

初めての貢献者も歓迎します！ 👋

オープンソースは初めてですか？問題ありません！ good-first-issue または help-wanted のタグが付いた課題を探してください。成功を支援するためのメンターシップとガイダンスを提供します。

すべての人にとってテスト自動化をより良くしてくれてありがとうございます！ 🚀