🚀 mcp-android-adb-server
2025.04.12
7
Go安卓设备控制自动化测试adb工具浏览器自动化开发效率
mcp-android-adb-server 是一个通过 adb 操作安卓设备的 MCP 服务。它提供了丰富的功能，包括应用管理、屏幕控制、输入控制、手势控制、设备信息获取等。此外，它还支持通过视觉模型（如 qwen2.5-vl）获取屏幕描述内容，增强了自动化操作的能力。
View on GitHub
Overview
🚀 基本能力
产品定位
mcp-android-adb-server 是一个用于通过 adb 操作安卓设备的 MCP 服务，主要用于安卓设备的自动化控制和信息获取。
核心功能
- 应用管理
- 安装、卸载、终止、启动应用程序
- 列出已安装的应用程序
-
检查特定应用程序是否已安装
-
屏幕控制
- 解锁、锁定屏幕
-
检查屏幕状态（是否锁定、是否活跃）
-
输入控制
- 输入文本、按键
- 点击、长按指定位置
-
执行返回操作
-
手势控制
-
执行上下左右滑动手势
-
设备信息
- 获取屏幕尺寸、DPI
- 获取屏幕截图描述
-
获取系统信息
-
其他功能
- 执行 shell 命令
- 通过视觉模型获取屏幕描述内容
适用场景
- 安卓设备的自动化测试
- 安卓应用的自动化安装和卸载
- 屏幕操作的自动化控制
- 设备信息的自动化获取
- 通过视觉模型增强的自动化操作
🛠 使用教程
使用依赖
- 确保已安装 adb 工具并配置好环境变量。
- 确保设备已通过 USB 连接并启用 USB 调试模式。
安装教程
# clone the repo and build
git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build
配置
在配置文件中设置以下环境变量：
{
"mcpServers": {
"mcp-android-adb-server": {
"command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
"env": {
"DEVICE_ID": "xxxxx",
"SCREEN_LOCK_PASSWORD": "123456",
"VISUAL_MODEL_ON": "true",
"VISUAL_MODEL_API_KEY": "sk-or-xxxxxxxxxxxxxxxxxxx",
"VISUAL_MODEL_BASE_URL": "https://openrouter.ai/api/v1/",
"VISUAL_MODEL_NAME": "qwen/qwen2.5-vl-72b-instruct:free"
}
}
}
}
环境变量
DEVICE_ID: 必需。Android 设备的 ID，可以通过adb devices命令获取。SCREEN_LOCK_PASSWORD: 可选。设备的屏幕锁定密码，用于解锁屏幕。VISUAL_MODEL_ON: 可选。是否启用视觉模型，默认为 false。VISUAL_MODEL_API_KEY: API密钥。VISUAL_MODEL_BASE_URL: API BaseURL。VISUAL_MODEL_NAME: 模型名称。
调试方式
- 确保设备已连接并可通过 adb 访问。
- 运行服务后，可以通过日志查看操作结果。
- 使用提供的功能命令进行测试，例如：
install_app安装应用unlock_screen解锁屏幕input_text输入文本screenshot_description获取屏幕描述