Appium MCP

🚀 MCP Appium - モバイル開発と自動化のためのMCPサーバー | iOS、Android、シミュレーター、エミュレーター、実機

MCP Appiumは、AIアシスタントにモバイル自動化のための強力なツール群を提供する、インテリジェントなMCP（Model Context Protocol）サーバーです。自然言語による対話、インテリジェントなロケーター生成、そしてAndroidとiOS両プラットフォーム向けの自動テスト作成を可能にすることで、モバイルアプリのテストを効率化します。

🚀 クイックスタート

MCP Appiumを使ってモバイルアプリの自動化テストを始めましょう。まずは必要な前提条件を満たし、インストールと設定を行います。

✨ 主な機能

• クロスプラットフォーム対応：Android（UiAutomator2）とiOS（XCUITest）の両方のテストを自動化できます。
• インテリジェントなロケーター生成：優先度ベースの戦略を用いたAIによる要素識別が可能です。
• インタラクティブなセッション管理：ローカルのモバイルデバイスで簡単にセッションを作成し管理できます。
• スマートな要素操作：クリック、テキスト入力、スクリーンショット撮影、要素検索などのアクションを実行できます。
• 自動テスト生成：自然言語の説明からJava/TestNGのテストコードを生成します。
• ページオブジェクトモデル対応：業界のベストプラクティスに沿った組み込みテンプレートを利用できます。
• 柔軟な設定：異なる環境に合わせて機能と設定をカスタマイズできます。

📦 インストール

前提条件

システム要件

• Node.js (v22以上)
• npm または yarn
• Java Development Kit (JDK) (8以上)
• Android SDK (Androidテスト用)
• Xcode (macOSでのiOSテスト用)

モバイルテストのセットアップ

Android

1. Android StudioとAndroid SDKをインストールします。
2. ANDROID_HOME環境変数を設定します。
3. Android SDKツールをシステムのPATHに追加します。
4. AndroidデバイスでUSBデバッグを有効にします。
5. Appium UiAutomator2ドライバーの依存関係をインストールします。

iOS (macOSのみ)

1. App StoreからXcodeをインストールします。
2. Xcodeコマンドラインツールをインストールします: xcode-select --install。
3. Xcodeを通じてiOSシミュレーターをインストールします。
4. 実機テストの場合は、プロビジョニングプロファイルを設定します。

インストール方法

標準設定

ほとんどのツールでは、以下の標準設定が機能します。

{
  "mcpServers": {
    "appium-mcp": {
      "disabled": false,
      "timeout": 100,
      "type": "stdio",
      "command": "npx",
      "args": [
        "appium-mcp@latest"
      ],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk",
        "CAPABILITIES_CONFIG": "/path/to/your/capabilities.json"
      }
    }
  }
}

Cursor IDEでのインストール

Cursor IDEでMCP Appiumをインストールする最も簡単な方法は、ワンクリックインストールボタンを使用することです。 これにより、Cursor IDEの設定にMCPサーバーが自動的に構成されます。設定内のANDROID_HOME環境変数を、あなたのAndroid SDKパスに合わせて更新してください。

または手動でインストールする場合

Cursor Settings → MCP → Add new MCP Serverに移動します。好きな名前を付け、コマンドタイプでnpx -y appium-mcp@latestを使用します。Editをクリックして設定を確認したり、コマンド引数を追加したりすることもできます。

以下は推奨設定です。

{
  "appium-mcp": {
    "disabled": false,
    "timeout": 100,
    "type": "stdio",
    "command": "npx",
    "args": ["appium-mcp@latest"],
    "env": {
      "ANDROID_HOME": "/Users/xyz/Library/Android/sdk"
    }
  }
}

注意: ANDROID_HOMEパスを、あなたのAndroid SDKインストールパスに合わせて更新してください。

Gemini CLIを使用する場合

Gemini CLIを使用してMCP Appiumサーバーを追加します。

gemini mcp add appium-mcp npx -y appium-mcp@latest

これにより、Geminiで使用するためのMCPサーバーが自動的に構成されます。設定内のANDROID_HOME環境変数を、あなたのAndroid SDKパスに合わせて更新してください。

Claude Code CLIを使用する場合

Claude Code CLIを使用してMCP Appiumサーバーを追加します。

claude mcp add appium-mcp -- npx -y appium-mcp@latest

これにより、Claude Codeで使用するためのMCPサーバーが自動的に構成されます。設定内のANDROID_HOME環境変数を、あなたのAndroid SDKパスに合わせて更新してください。

🔧 技術詳細

設定

機能設定

デバイスの機能を定義するために、capabilities.jsonファイルを作成します。

{
  "android": {
    "appium:app": "/path/to/your/android/app.apk",
    "appium:deviceName": "Android Device",
    "appium:platformVersion": "11.0",
    "appium:automationName": "UiAutomator2",
    "appium:udid": "your-device-udid"
  },
  "ios": {
    "appium:app": "/path/to/your/ios/app.ipa",
    "appium:deviceName": "iPhone 15 Pro",
    "appium:platformVersion": "17.0",
    "appium:automationName": "XCUITest",
    "appium:udid": "your-device-udid"
  }
}

CAPABILITIES_CONFIG環境変数を設定して、この設定ファイルを指すようにします。

スクリーンショット設定

SCREENSHOTS_DIR環境変数を設定して、スクリーンショットの保存場所を指定します。設定しない場合、スクリーンショットは現在の作業ディレクトリに保存されます。絶対パスと相対パスの両方をサポートしています（相対パスは現在の作業ディレクトリから解決されます）。ディレクトリが存在しない場合は自動的に作成されます。

利用可能なツール

MCP Appiumは、以下のカテゴリに分類された包括的なツール群を提供します。

プラットフォームとデバイスのセットアップ

セッション管理

コンテキスト管理

要素の探索と操作

画面とナビゲーション

アプリ管理

テスト生成とドキュメント

🤖 クライアントサポート

MCP Appiumは、MCP準拠の任意のクライアントと互換性があるように設計されています。

💻 使用例

アマゾンモバイルアプリのチェックアウトフロー

アマゾンモバイルアプリのチェックアウトプロセスをテストするための例のプロンプトを次に示します。

Open Amazon mobile app, search for "iPhone 15 Pro", select the first search result, add the item to cart, proceed to checkout, sign in with email "test@example.com" and password "testpassword123", select shipping address, choose payment method, review order details, and place the order. Use JAVA + TestNG for test generation.

この例は、MCP Appiumのインテリジェントなロケーター生成とテスト作成機能を使用して自動化できる完全な電子商取引のチェックアウトフローを示しています。

🙌 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信したり、問題を開いて変更について議論したりしてください。

📄 ライセンス

このプロジェクトはApache-2.0ライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。