QApilot MCP for Androidは、AIコーディングクライアントをローカルのAndroid端末に接続し、Appiumコードを手動で書くことなく自然言語によるテスト実行を可能にするツールです。
製品の機能と公式な位置づけ
QApilot MCP for Androidは、Claude DesktopやCursorなどのAIアシスタントからモバイルアプリのテスト実行を可能にするModel Context Protocol対応のCLIブリッジです。ローカルのAppiumサーバーやAndroid Debug Bridge環境に直接接続し、手動でAppiumやUIAutomatorのスクリプトを記述することなく、物理デバイスやエミュレータを操作できます。
このツールは、対話形式のプロンプトを構造化された実行計画に変換し、手動アクションの実行、ブラウザプレビューへのリアルタイム画面ストリーミング、そして検証済みテストパスのQApilotプロジェクトへの保存を通じてテストフローを自動化します。テスト実行完了時には、構造化データ、Gherkin仕様、およびセッションメトリクスを出力します。
公式情報で確認できる活用例
品質エンジニアが自然言語でテスト操作を指示することで、AIクライアントが構造化テスト計画を策定し、接続されたAndroid端末上でアクションを実行してスクリーンショットを取得します。
登録済みのテストケースをID順に順次再実行したり、Excel（.xlsx）スプレッドシートから読み込んだテストスイート全体を接続済みエミュレータに対して一括実行したりできます。
公式情報に記載された利用手順
Node.js 18以上、Java JDK 11以上、Android SDKなどの前提条件を確認し、指定のuiautomator2ドライバとともにAppium 2.19.0を起動します。
Claude Desktop、Cursor、または互換性のあるAIクライアントのMCP設定ファイルに、qapilot-mobile-mcpコマンドと引数を追加します。
QApilotワークスペースにログインし、Androidのパッケージ識別子を指定してテスト対象アプリケーションを起動します。
AIアシスタントに操作を指示し、ライブプレビューURLで進捗をリアルタイム確認しながら、成功した正常系ステップをQApilotに取り込みます。
セッションレポートを生成してJSON、YAML、Gherkinファイルを出力し、次回以降の実行に向けて実行状態をクリアします。
本CLIは標準入出力を介して通信するMCPサーバーとして動作し、デバイス管理、計画作成、アクション実行、状態問い合わせのための専用ツールを提供します。AIクライアントはmobile_launch_app、mobile_submit_plan、mobile_executeなどのツールを使用して、Appiumセッションのライフサイクルをプログラムから直接制御します。
実行中には状態確認コマンドにより進捗状況を照会し、キャッシュされたアプリ操作定義やXPathを取得できます。テストセッションが完了してレポート生成ツールが呼び出されると、テスト成果物がローカルのダウンロードディレクトリに出力され、アクティブな実行コンテキストが初期化されます。
自分の素材とワークフローで確認したい項目
確認した情報源とその日時
情報源を確認した製品情報に基づく回答
このサーバーはClaude Desktop、Cursor、OpenAI Codex、またはModel Context Protocolと互換性のある任意のAIツールと連携して設定できます。
公式ドキュメントでは、バージョン4.2.6のuiautomator2ドライバがインストールされたAppium 2.19.0の環境が必要とされています。
いいえ、登録対象となるのは正常系のステップのみです。失敗したステップは除外されるため、テストケースとして保存する前に問題を修正する必要があります。
レポートはユーザーのダウンロードディレクトリに保存され、output.json、report.yaml、および通過セッション用のscenario.feature（Gherkinファイル）が含まれます。
はい、mobile_run_excel_testcasesツールを使用することで、Excelファイル（.xlsx）から保存済みテストケースを直接一括実行することが可能です。
