Neverlow512/agent-droid-bridge

Agent Droid Bridge is an MCP server that gives AI agents programmatic control over Android devices and emulators via ADB. Connect any MCP-capable AI client (Cursor, Claude Desktop, VS Code) to a real or emulated Android device and let agents see the screen, interact with the UI, run shell commands, and detect when the screen changes.

PyPI: https://pypi.org/project/agent-droid-bridge/0.1.1/

Demo https://youtu.be/otIWBBNe-VU

Install

uvx agent-droid-bridge

MCP config

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": ["agent-droid-bridge"],
      "env": {
        "ADB_EXECUTION_MODE": "unrestricted",
        "ADB_ALLOW_SHELL": "true"
      }
    }
  }
}

11 tools

Tool | What it does
-- | --
get_ui_hierarchy | Returns the current screen as an XML UI hierarchy
take_screenshot | Captures the screen as a base64-encoded PNG
tap_screen | Sends a tap at pixel coordinates
swipe_screen | Sends a swipe between two points
type_text | Types text into the focused input field
press_key | Sends an Android keycode (Back, Home, Enter, etc.)
launch_app | Launches an app by component name
execute_adb_command | Runs any ADB or ADB shell command
list_devices | Lists all connected devices with serial, state, and model
snapshot_ui | Takes a lightweight UI snapshot, returns a token
detect_ui_change | Polls for UI changes after an action

Requirements

• Python 3.11+
• ADB installed and in PATH
• Android device or emulator with USB debugging enabled

Notes

• Alpha — APIs may change before 1.0
• Tested on Linux with Android emulators
• Security controls: allowlist mode, ADB_ALLOW_SHELL toggle