Android Debug Bridge

Android Debug Bridge 是一个基于 ADB 和 MCP 协议的 Android 设备控制服务器，通过程序化方式实现对 Android 设备的管理。它支持执行 ADB 命令、捕获屏幕截图、分析 UI 布局以及管理应用程序，适用于自动化测试、远程调试等开发场景。

核心功能

Android Debug Bridge 提供了多种核心功能，帮助开发者高效管理 Android 设备：

• ADB 命令执行：支持直接运行 ADB 命令，便于设备管理和调试。
• 设备截图捕获：可以轻松获取设备屏幕截图，用于记录或分享。
• UI 布局分析：识别当前 UI 中的可点击元素及其属性，便于快速定位。
• 包管理：列出已安装的应用程序列表，方便管理和更新。

安装方法

安装 Android Debug Bridge 需要 Python 3.x 环境以及 ADB 工具。以下是详细的安装步骤：

1. 克隆仓库：将项目克隆到本地。

git clone https://github.com/minhalvp/android-mcp-server.git

1. 安装依赖：使用 uv 工具安装 Python 3.11 并同步依赖。

uv python install 3.11
uv sync

1. 配置设备：创建并编辑配置文件，指定目标设备 ID。

touch config.yaml

echo '{"device": {"name": "google-pixel-7-pro:5555"}}' > config.yaml

1. 启动服务器：运行服务器脚本以启动服务。

uv run server.py

使用方法

Android Debug Bridge 可通过支持 MCP 协议的客户端（如 Claude 桌面）进行访问。以下是使用示例：

get_packages()

该命令用于获取设备上所有已安装的应用程序列表。

execute_adb_command('shell pm list packages')

该命令用于执行 ADB 命令，列出设备上的所有软件包。

get_screenshot()

该命令用于截取设备屏幕快照。

使用场景

Android Debug Bridge 适用于多种开发场景，包括：

• 自动化测试：通过程序化方式控制设备，实现自动化测试流程。
• 远程调试：支持远程连接设备，便于调试和问题排查。
• UI 分析：识别 UI 元素，便于自动化点击和交互。
• 应用管理：快速查看和管理设备上的应用程序。

注意事项

在使用 Android Debug Bridge 时，需要注意以下事项：

• 确保设备已启用 ADB 并正确连接。
• 需要安装 Python 3.x 环境及相关依赖。
• 对某些高级功能可能需要一定的技术背景。
• 未全面测试所有 Android 版本和设备。

配置说明

Android Debug Bridge 使用 YAML 格式的配置文件（`config.yaml`）来指定目标设备。以下是一个示例配置：

device:
  name: "google-pixel-7-pro:5555"

其中，`name` 字段应填写设备标识符，可以通过 `adb devices` 命令获取。

总结

Android Debug Bridge 是一个功能强大的 Android 设备控制工具，通过 ADB 和 MCP 协议实现了设备管理、命令执行、截图捕获和 UI 分析等功能。它适用于自动化测试、远程调试等场景，为开发者提供了高效、便捷的设备管理方式。