← Index

Agent Droid Bridge

io.github.Neverlow512/agent-droid-bridge·v0.6.1·Other
Quality Score
85
/100

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

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ],
      "env": {
        "ADB_EXECUTION_MODE": "unrestricted",
        "ADB_ALLOW_SHELL": "true",
        "ADB_PATH": "adb",
        "ADB_EXTRA_TOOL_PACKS": "<adb_extra_tool_packs>",
        "ADB_DENIED_TOOLS": "<adb_denied_tools>",
        "ADB_SHELL_ALLOWLIST": "<adb_shell_allowlist>",
        "ADB_SHELL_DENYLIST": "<adb_shell_denylist>",
        "MCP_LOG_ENABLED": "false",
        "MCP_LOG_DIR": "<mcp_log_dir>",
        "ADB_LOG_LEVEL": "INFO",
        "ADB_COMMAND_TIMEOUT": "30",
        "ADB_SCREENSHOT_TIMEOUT": "60",
        "ADB_UI_CHANGE_TIMEOUT": "10",
        "ADB_UI_CHANGE_POLL_INTERVAL": "0.5",
        "ADB_AAPT_TIMEOUT": "10",
        "ADB_CONFIG_SOURCE": "env"
      }
    }
  }
}
§02  Environment variables
ADB_EXECUTION_MODE

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

ADB_ALLOW_SHELL

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

ADB_PATH

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

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

MCP_LOG_DIR

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

ADB_LOG_LEVEL

Server process log level.

ADB_COMMAND_TIMEOUT

Maximum seconds to wait for any ADB command.

ADB_SCREENSHOT_TIMEOUT

Maximum seconds to wait for a screenshot capture.

ADB_UI_CHANGE_TIMEOUT

Default timeout in seconds for detect_ui_change.

ADB_UI_CHANGE_POLL_INTERVAL

How often in seconds detect_ui_change polls the UI hierarchy.

ADB_AAPT_TIMEOUT

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

ADB_CONFIG_SOURCE

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

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
5
§04  Alternatives in Other