Skip to content
Windsurf

Agent Droid Bridge for Windsurf

io.github.neverlow512/agent-droid-bridge

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

client:Windsurf transport:stdio runtime:pypi

Install Agent Droid Bridge in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "agent-droid-bridge": {
      "command": "uvx",
      "args": [
        "agent-droid-bridge"
      ],
      "env": {
        "ADB_EXECUTION_MODE": "<ADB_EXECUTION_MODE>",
        "ADB_ALLOW_SHELL": "<ADB_ALLOW_SHELL>",
        "ADB_PATH": "<ADB_PATH>",
        "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": "<MCP_LOG_ENABLED>",
        "MCP_LOG_DIR": "<MCP_LOG_DIR>",
        "ADB_LOG_LEVEL": "<ADB_LOG_LEVEL>",
        "ADB_COMMAND_TIMEOUT": "<ADB_COMMAND_TIMEOUT>",
        "ADB_SCREENSHOT_TIMEOUT": "<ADB_SCREENSHOT_TIMEOUT>",
        "ADB_UI_CHANGE_TIMEOUT": "<ADB_UI_CHANGE_TIMEOUT>",
        "ADB_UI_CHANGE_POLL_INTERVAL": "<ADB_UI_CHANGE_POLL_INTERVAL>",
        "ADB_AAPT_TIMEOUT": "<ADB_AAPT_TIMEOUT>",
        "ADB_CONFIG_SOURCE": "<ADB_CONFIG_SOURCE>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

Agent Droid Bridge in other clients