mcp-android

mcp-android

ADB 経由で Android スマートフォンを操作するModel Context Protocol サーバーです。Mac 操作サーバーのスマートフォン版です。Claude は画面（スクリーンショットと UI 階層）を確認し、タップ、文字入力、キー入力、アプリの起動、アラームやタイマーの設定、通知の読み取りを行えます。安全性をデフォルトで確保し、スイートのアクセスモードとフラグのモデルを採用しています。

コンピューター上で実行し、USB またはワイヤレスデバッグで接続したスマートフォンを操作します（Z Fold 7 に最適です）。スマートフォンにはインストールされず、root 権限も必要ありません。

iOS の場合は？ 標準状態の iPhone はこの方法では操作できません。Apple のサンドボックスでは、アプリ間またはシステム全体にわたる自動化が禁止されています。現実的な方法（Mac から USB 経由で Appium/WebDriverAgent を使用する方法）については、別の mcp-ios リポジトリをご覧ください。

クイックスタート

brew install android-platform-tools        # provides adb
# On the phone: Settings → Developer options → enable USB (or Wireless) debugging, then authorize this computer
adb devices                                 # confirm your device shows "device"

npm から直接実行できます。クローンもビルドも不要です。

npx -y @dockndevai/mcp-android

または、Claude Code に1行で追加できます（まずは読み取り専用で開始します）。

claude mcp add android -e ANDROID_MODE="read-only" -- npx -y @dockndevai/mcp-android

Claude Desktop、Cursor、Codex、Windsurf、VS Code の設定については、docs/CLIENTS.md をご覧ください。

ソースからセットアップ

brew install android-platform-tools        # provides adb
adb devices                                 # confirm your device shows "device"
npm install && npm run build

ツール

読み取り（read-only 以上）：list_devices、device_info、screenshot、ui_dump、current_app、list_apps、get_notifications

書き込み（read-write 以上）：tap、swipe、input_text、press_key、launch_app、open_url、set_alarm、set_timer

管理者（admin）：install_apk、uninstall_app、clear_app_data（ANDROID_ALLOW_INSTALL が必要）、run_shell（ANDROID_ALLOW_SHELL が必要。それ以外の場合は登録されません）

UI 操作の一般的な流れは、screenshot → ui_dump（境界を確認）→ tap/input_text です。

セキュリティモデル

項目	フラグ	デフォルト
実行可能な操作	ANDROID_MODE	read-only
対象パッケージ	ANDROID_PACKAGE_ALLOWLIST	(すべて)
保護対象パッケージ（アンインストール／消去不可）	ANDROID_PROTECTED_PACKAGES	settings、systemui、gms
インストール／アンインストール／消去を許可	ANDROID_ALLOW_INSTALL	false
生の adb shell を許可	ANDROID_ALLOW_SHELL	false
対話形式の確認（破壊的な操作）	MCP エリシテーション（クライアント主導）	(クライアントが対応している場合は有効)
デバイスに触れずにプレビュー	ANDROID_DRY_RUN	false
監査ログ（stderr）	ANDROID_AUDIT_LOG	true

接続されたクライアントが MCP のエリシテーションに対応している場合、破壊的な操作を行うツール（uninstall_app、clear_app_data、install_apk、run_shell）は一時停止し、実行前に人間に操作内容を確認して承認を求めます。モデルがユーザーに代わって承認することはできません。クライアントがエリシテーションに対応していない場合は、上記のアクセスモードとフラグによる制限が制御手段となります。

Claude Desktop／Claude Code で実行

{
  "mcpServers": {
    "android": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-android/dist/index.js"],
      "env": { "ANDROID_MODE": "read-write" }
    }
  }
}

プロンプトの例

• 「スマートフォンのスクリーンショットを撮って、画面に何が表示されているか教えてください。」
• 「午前6時30分に『ジム』というラベルのアラームを設定してください。」
• 「時計アプリを開いて、10分のタイマーを開始してください。」
• 「通知がたくさんたまっていますか？」

開発

npm run dev
npm test          # security policy
npm run typecheck

ライセンス

MIT