v2.0.0 — Android MCP

What's new in v2.0.0

Architecture

• 7 categorical MCP tools replacing the old 44-function flat API:
  • android_device · android_screen · android_interact · android_app · android_files · android_system · android_automation
• Multi-device support — all tools accept an optional device_id.

Live Viewer

• python viewer.py — 90fps interactive scrcpy window on PC (click = tap on phone).
• --record — record session to .mp4.
• --multi — one viewer per connected device.

Setup

• python mcp_config.py --client <claude|opencode|windsurf|cursor> — auto-generates the correct JSON config.
• WiFi ADB support (Android 11+ wireless debugging, no USB needed).

Quality

• 94 unit tests (no device required).
• 13 integration tests on real device.
• Automatic retry on screenshot failure.
• Clear error messages when device is offline.

Requirements

• Python 3.10+
• ADB in PATH
• Android device with developer mode enabled

Quick start

git clone [https://github.com/Steph-ux/android-mcp](https://github.com/Steph-ux/android-mcp)
cd android-mcp
pip install -r requirements.txt
python mcp_config.py --client claude --write