Agent Droid Bridge

Droid Bridge探员

Agent Droid Bridge是一个MCP服务器，通过ADB将AI代理连接到Android设备和模拟器。它是为移动自动化、应用程序测试、动态分析和逆向工程而构建的：将ADB的整个表面暴露为任何兼容MCP的AI客户端都可以直接调用的结构化工具。如果亚行能做到，代理人也能做到。

______________________________________________________________________

专门构建的工具返回结构化的、最小的响应。没有原始XML转储，没有浪费的上下文——代理在长会话中保持快速。


演示


上面的演示通过一些简单的任务来展示连接的代理可以做什么，这只是触及了表面：

• 安装Paint应用程序，打开它，并通过计算墙壁和屋顶的像素坐标来绘制房屋
• 打开设备浏览器，搜索“MCP维基百科”，导航到结果页面，并截图
• 打开计算器，计算1337×42，并将结果提取到主机
• 打开联系人，创建一个包含姓名和电话号码的新条目，并确认已保存
• 打开日历并为特定日期安排约会
• 打开设置并切换黑暗模式
• 将计算器APK从设备提取到主机
• 安装记事本，为完成的每项任务写一句话摘要，并拍摄最终截图

它的作用

工具

• 14个内置工具，用于屏幕截图、UI检查、文本读取、元素提取、触摸和滑动输入、文本输入、按键代码事件、应用程序启动、ADB命令和设备检查
• app_manager pack增加了9个工具，用于包管理、应用生命周期、APK提取、权限和意图注入。加载它 ADB_EXTRA_TOOL_PACKS=app_manager
• 工具可用性反映在服务器的启动说明中。代理在连接时收到准确的目录

设备处理

• 自动检测单个连接的设备；存在多个设备时的选择提示
• 运行在stdio上，与任何支持MCP的AI客户端兼容
• 结构化响应而不是原始XML转储，在长时间的自动化运行中保持代理上下文的精简

安全

• 两种执行模式： unrestricted （完全访问ADB，可选denylist）和 restricted （仅限allowlist，阻止所有未明确允许的内容）
• 集 ADB_ALLOW_SHELL=false 禁用所有shell命令，无论模式如何
• 使用以下命令向代理隐藏特定工具 ADB_DENIED_TOOLS
• 通过解析所有命令 shlex无法进行外壳注射

可观测性

• 可选的会话记录器将每个工具调用、ADB命令和安全事件记录到结构化JSONL文件中。启用 MCP_LOG_ENABLED=true 和 MCP_LOG_DIR

用例

移动QA和测试自动化 自动化跨真实设备和模拟器的UI流，而无需修改应用程序或编写测试代码。点击、滑动、键入、阅读屏幕内容、截图——所有这些都来自自然语言提示。

应用安全研究 提取APK，检查声明的权限，触发任意意图，并观察屏幕上的运行时行为。无需仪器，无需越狱。

动态分析 在受控状态下启动应用程序，驱动UI交互，在每一步捕获屏幕状态，并提取工件——所有这些都可以通过AI代理编写脚本。

开发与调试 安装构建、验证UI状态、检查应用程序信息，并在不离开编码环境的情况下运行ADB命令。

安装

uvx agent-droid-bridge

无需克隆或虚拟环境。需要在主机上安装Python 3.11+和ADB。

uvx 由提供 紫外线。如果您没有： curl -LsSf https://astral.sh/uv/install.sh | sh

要改为从源代码安装，请参阅 docs/setup.md--选项B.

要验证安装，请执行以下操作： uvx agent-droid-bridge --help

快速开始

1. 安装ADB——请参阅 docs/setup.md 针对特定平台的说明
2. 连接Android设备或启动模拟器
3. 将服务器添加到MCP客户端配置中：

{
  "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": "",
        "MCP_LOG_ENABLED": "false",
        "MCP_LOG_DIR": "~/logs/agent-droid-bridge"
      }
    }
  }
}

要启用会话日志记录，请设置 MCP_LOG_ENABLED 到 "true" 并更新 MCP_LOG_DIR 到计算机上的可写路径。

1. 提示您的代理人使用 agent-droid-bridge MCP工具

完整的设置指南和环境变量参考： docs/setup.md

工具

额外工具包

可选包扩展了核心工具集。通过设置启用它们 ADB_EXTRA_TOOL_PACKS 在您的MCP客户端配置中。看 docs/extra-tool-packs.md.

应用程序管理员

包管理、应用生命周期控制、APK提取、权限管理和意图注入。

完整参数参考： docs/tools.md

配置

完全从MCP客户端配置服务器 env 块。没有要编辑的文件。上面快速入门中的env块涵盖了最常见的设置。有关包括安全筛选、工具可见性和超时在内的完整参考，请参阅 docs/configuration.md.

要改用YAML配置文件，请设置 ADB_CONFIG_SOURCE=yaml。参见 docs/configuration.md 了解详情。

会话录制是单独的。启用它 MCP_LOG_ENABLED=true 和 MCP_LOG_DIR.完整参考： docs/logging.md.

文档

贡献

欢迎捐款。看 贡献.md 有关设置、代码标准和提交pull请求的指南。

要报告安全漏洞，请按照中的流程进行操作 安全.md --不要公开问题。