MCP Android Agent
JSON →Automate Android devices using the uiautomator2 library, requiring adb and a connected device.
Install
pip install
``` Tools · 33
- connect_device Automatically detects and connects to an available Android device via ADB
- get_device_info Retrieves comprehensive device information including serial, resolution, battery, WiFi IP, and Android version
- adb_diagnostics Checks ADB availability and connection status
- health_check Built-in server health monitoring
- list_apps Lists all installed applications (system + user apps)
- start_app Starts an application by package name
- stop_app Stops an application by package name
- force_stop_app Force-stops an application by package name
- get_foreground_app Tracks current foreground app and activity
- clear_app_data Clears app data/cache for testing
- screen_on Turns screen on programmatically
- screen_off Turns screen off programmatically
- unlock_screen Smart screen unlocking with standard methods
- wait_for_screen Waits for screen activation (async support)
- click_by_text Clicks on UI element by text
- click_by_resource_id Clicks on UI element by resource ID
- click_by_content_description Clicks on UI element by content description
- long_click Performs a long click gesture
- swipe Performs a swipe gesture
- drag Performs a drag operation
- input_text Smart text entry with optional field clearing
- press_home Simulates pressing the home button
- press_back Simulates pressing the back button
- press_menu Simulates pressing the menu button
- press_volume_up Simulates pressing the volume up key
- press_volume_down Simulates pressing the volume down key
- get_element_properties Gets detailed UI element properties and bounds
- take_screenshot Takes a screenshot for debugging and documentation
- export_ui_hierarchy Exports complete screen structure as XML
- wait_for_element Waits for element to appear with custom timeout
- scroll_to_element Auto-scrolls to find elements in long lists
- get_toast Captures system toast messages for verification
- wait_for_activity Waits for specific Android activity
Links
★ 53 GitHub stars