agent-droid-bridge

agent-droid-bridge

Agent Droid Bridge gives AI agents programmatic control over Android devices and emulators via ADB, exposed as an MCP server.

Category
Visit Server

README

Python 3.11+ License MIT MCP Compatible PyPI

Agent Droid Bridge

A FastMCP server that gives AI agents programmatic control over Android devices and emulators via ADB.

Demo

Agent Droid Bridge Demo

agent-droid-bridge MCP server

Install

uvx agent-droid-bridge

No cloning or virtual environments needed. Requires Python 3.11+ and ADB installed on your host.

What it does

  • Exposes 11 MCP tools covering screen interaction, UI inspection, text input, and arbitrary ADB commands
  • Auto-detects the connected device when only one is present; presents a device list and requires the user to choose when multiple are connected
  • Parses all commands safely via shlex — no shell injection possible
  • Runs over stdio, making it compatible with any MCP-capable AI client

Quick start

  1. Install ADB — see docs/setup.md for platform-specific instructions
  2. Connect an Android device or start an emulator
  3. Add the server to your MCP client config:
{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": ["agent-droid-bridge"],
      "env": {
        "ADB_EXECUTION_MODE": "unrestricted",
        "ADB_ALLOW_SHELL": "true"
      }
    }
  }
}
  1. Prompt your agent to use the agent-droid-bridge MCP tools

Full setup guide: docs/setup.md

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 gesture at pixel coordinates
swipe_screen Sends a swipe gesture between two points over a given duration
type_text Types text into the focused input field
press_key Sends an Android keycode event (Back, Home, Enter, etc.)
launch_app Launches an app by its package/activity component name
execute_adb_command Runs an arbitrary ADB or ADB shell command
list_devices Lists all Android devices currently visible to ADB with their serial, state, and model
snapshot_ui Takes a lightweight UI snapshot and returns a token for use with detect_ui_change
detect_ui_change Polls for a UI change after an action; accepts a snapshot token as baseline; returns hierarchy only when requested

Full parameter reference: docs/tools.md

Documentation

File Description
docs/setup.md Prerequisites, installation, and MCP client configuration
docs/tools.md Full parameter reference for all 11 tools
docs/configuration.md Reference for adb_config.yaml and environment variables

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured