android

Android MCP Server

ADB を介して Android エミュレーターやデバイスを操作するための MCP サーバーです。AI アシスタントが Android アプリを確認、操作、デバッグできるようにします。スクリーンショットの撮影、要素のタップ、ログの読み取り、バグの記録などが可能です。

npm Package | GitHub | Issues

^ 見やすいように再生速度を上げています。その他のデモとテストケース。

機能

• 25 個のツールで Android デバイスを完全に制御
• スクリーンショットの撮影とインテリジェントな圧縮（Sharp ベース、最大 1280px）
• UI ツリーの検査 — 境界、テキスト、リソース ID、状態を含む要素階層を読み取り
• タッチ操作の自動化 — タップ、スワイプ、スクロール、テキスト入力、ハードウェアキーの押下
• 要素の指定 — resource-id、テキスト、content-desc による要素の検索とタップ
• アプリのライフサイクル — APK のインストール、アプリの起動、現在のアクティビティの確認
• Logcat 統合 — パッケージ、ログレベル、タイムスタンプによるフィルタリング
• デバイス管理 — デバイスの一覧表示、エミュレーターの起動、デバイス情報の取得
• 複合アクション — tap_and_wait はタップ、安定待ち、UI ツリー取得を 1 回の往復処理にまとめます
• 永続的な ADB シェル — 1 つのシェルセッションを再利用してコマンド実行を高速化
• デバイス情報のキャッシュ — セッションごとにデバイスのプロパティを 1 回だけ照会
• 複数デバイスのサポート — ID を指定して特定のデバイスを対象にできます
• アプリの変更は不要 — SDK 統合なしで、ADB を介してあらゆる Android アプリで動作

前提条件

• Node.js 18+
• platform-tools（ADB）とエミュレーターを含む Android SDK
• 起動中の Android エミュレーター、または接続済みのデバイス

ANDROID_HOME の確認方法

サーバーは ~/Library/Android/sdk（macOS）または ANDROID_HOME から SDK を自動検出します。SDK が別の場所にある場合は、MCP 設定で ANDROID_HOME を設定してください（下記参照）。

確認するには：

# macOS
ls ~/Library/Android/sdk/platform-tools/adb

# Or find it via Android Studio: Settings > Languages & Frameworks > Android SDK

セットアップ

claude mcp add --scope user android -- npx -y android-mcp-server

claude mcp add --scope user --env ANDROID_HOME=/path/to/sdk android -- npx -y android-mcp-server

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "android-mcp-server"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "android": {
        "command": "npx",
        "args": ["-y", "android-mcp-server"],
        "env": {
          "ANDROID_HOME": "/path/to/android/sdk"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "android-mcp-server"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk"
      }
    }
  }
}

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "android-mcp-server"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk"
      }
    }
  }
}

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "android-mcp-server"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk"
      }
    }
  }
}

git clone https://github.com/martingeidobler/android-mcp-server.git
cd android-mcp-server
npm install
npm run build
claude mcp add --scope user android -- node /path/to/android-mcp-server/dist/index.js

利用可能なツール

デバイス管理

スクリーンショットと UI 分析

操作

診断

アプリ管理

ワークフローの例

バグの記録

「ログをクリアして、設定画面を開き、保存ボタンをタップしてから、ログとスクリーンショットを表示してください」

Claude は次の操作を行います：clear_logs → launch_app → tap_element → get_logs(package_name="com.example.app", level="E") → screenshot(save_path="./bugs/settings-crash.png")

UI テスト

「ログインフローを進め、各画面がデザインと一致していることを確認してください」

Claude は screenshot と get_ui_tree を使って各画面を確認・把握し、tap_element／type_text で操作します。また、ビジョン機能を使ってモックアップや説明と照合します。

スモークテスト

「APK をインストールしてアプリを起動し、メイン画面を順にタップしてクラッシュしないことを確認してください」

Claude は次の操作を行います：install_apk → launch_app → tap_element で画面を移動 → 各画面の後に get_logs(level="E") でエラーを確認します。

要素の操作

「設定を開き、「display」を検索して、最初の結果をタップし、その後戻ってください」

Claude は次の操作を行います：launch_app(package_name="com.android.settings") → tap_and_wait(by="text", value="Search settings") → type_text("display") → tap_and_wait(by="text", value="Display") → press_key(key="back")

デモとプロンプトガイド

• DEMOS.md — 今すぐ試せる、コピーして貼り付けるプロンプトのシナリオ
• PROMPTING.md — ベストプラクティス、パフォーマンスのヒント、よくある落とし穴

仕組み

サーバーは Model Context Protocol を使用して stdio 経由で通信します。すべてのデバイス操作は ADB 経由で行われ、アプリの変更は不要です。スクリーンショットはメモリ内でキャプチャされ、圧縮された後、AI が視覚的に確認して分析できる base64 画像として返されます。

コントリビューション

コントリビューションを歓迎します！ガイドラインについては CONTRIBUTING.md をご覧ください。

ライセンス

MIT - LICENSE をご覧ください。