Android ADB MCP 服务器

Overview

基本能力

产品定位

Android ADB MCP 服务器是一个基于 MCP 协议的 Android ADB 服务器，主要用于通过 MCP 客户端远程控制连接到电脑的 Android 设备。

核心功能

设备管理：列出已连接的 Android 设备
屏幕操作：截图、点击、滑动（上下左右）
输入操作：文本输入、按键模拟
应用管理：安装/卸载应用、启动应用
系统操作：获取屏幕分辨率等设备信息
网络工具：获取网络状态、端口扫描、WIFI管理
文件工具：文件上传/下载、文件管理
高级工具：UI测试、性能分析、录屏、日志收集、增强型启动应用

适用场景

远程控制 Android 设备
自动化测试
应用调试
设备管理

工具列表

设备管理

list_devices: 列出所有连接的 Android 设备

屏幕操作

take_screenshot: 截取设备屏幕
tap_screen: 点击屏幕上的指定位置
swipe_up: 向上滑动
swipe_down: 向下滑动
swipe_left: 向左滑动
swipe_right: 向右滑动

输入操作

input_text: 输入文本
press_key: 按下指定按键
press_back: 按下返回键
press_home: 按下 Home 键

应用管理

start_app: 启动应用
install_apk: 安装APK
uninstall_app: 卸载应用

系统操作

get_screen_resolution: 获取屏幕分辨率

网络工具

get_ip_address: 获取设备IP地址
ping: 测试网络连接
scan_ports: 扫描指定端口
get_wifi_status: 获取WIFI状态
connect_wifi: 连接到WIFI网络

文件工具

list_files: 列出目录下的文件
upload_file: 上传文件到设备
download_file: 从设备下载文件
create_file: 创建文件
delete_file: 删除文件

高级工具

dump_ui_hierarchy: 获取界面层次结构
run_ui_test: 执行UI测试步骤
check_element_exists: 检查界面元素是否存在
tap_element_by_text: 点击包含指定文本的UI元素
collect_device_logs: 收集设备日志
analyze_performance: 分析应用性能
take_screen_recording: 录制设备屏幕视频
enhanced_start_app: 增强型应用启动功能，可绕过权限限制

常见问题解答

如果遇到问题，确保 ADB 服务器已启动 (adb start-server)
确保 Android 设备已授权您的电脑进行 USB 调试
某些操作可能需要 root 权限
如果遇到"Permission Denial"权限问题，请使用enhanced_start_app高级工具

使用教程

使用依赖

Python 3.10 或更高版本
ADB 已安装并添加到系统路径
Android 设备已启用 USB 调试并连接到电脑

安装教程

# 克隆此仓库
git clone https://github.com/wolfcoming/adb_mcp_server.git
cd adb_mcp_server

# 安装依赖
pip install -r requirements.txt

# 确保 ADB 服务器已启动
adb start-server

调试方式

确保 ADB 服务器已启动 (adb start-server)
确保 Android 设备已授权您的电脑进行 USB 调试
某些操作可能需要 root 权限
如果遇到"Permission Denial"权限问题，请使用enhanced_start_app高级工具

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。