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