agent-droid-bridge

Agent Droid Bridge

MCP server giving AI agents eyes and hands inside Android devices via ADB

stdiocommunityapplication

Package Details

agent-droid-bridge

0.6.1•https://pypi.org/project/agent-droid-bridge

Transportstdio

Runtimeuvx

Environment Variables

ADB_EXECUTION_MODE

Default:unrestricted

Security mode. 'unrestricted' allows all shell commands with an optional denylist. 'restricted' allows only commands in ADB_SHELL_ALLOWLIST.

ADB_ALLOW_SHELL(bool)

Default:true

Set to 'false' to block all adb shell commands regardless of execution mode.

ADB_PATH

Default:adb

Path to the ADB binary. Use a full path if adb is not on your system PATH.

ADB_EXTRA_TOOL_PACKS

Comma-separated list of extra tool packs to load. Set to 'app_manager' to enable 9 additional app management tools.

ADB_DENIED_TOOLS

Comma-separated list of tool names to hide from the agent at startup.

ADB_SHELL_ALLOWLIST

Comma-separated list of shell commands permitted in restricted mode. Empty blocks all shell commands.

ADB_SHELL_DENYLIST

Comma-separated list of shell commands blocked in unrestricted mode.

MCP_LOG_ENABLED(bool)

Default:false

Set to 'true' to enable session logging. Requires MCP_LOG_DIR.

MCP_LOG_DIR(file)

Absolute path to the directory where session logs are written. Required when MCP_LOG_ENABLED is true.

ADB_LOG_LEVEL

Default:INFO

Server process log level.

ADB_COMMAND_TIMEOUT(num)

Default:30

Maximum seconds to wait for any ADB command.

ADB_SCREENSHOT_TIMEOUT(num)

Default:60

Maximum seconds to wait for a screenshot capture.

ADB_UI_CHANGE_TIMEOUT(num)

Default:10

Default timeout in seconds for detect_ui_change.

ADB_UI_CHANGE_POLL_INTERVAL(num)

Default:0.5

How often in seconds detect_ui_change polls the UI hierarchy.

ADB_AAPT_TIMEOUT(num)

Default:10

Maximum seconds to wait for aapt dump badging, used by the app_manager pack.

ADB_CONFIG_SOURCE

Default:env

Set to 'yaml' to load configuration from adb_config.yaml instead of environment variables.