wolfcoming/adb_mcp_server

这是一个基于 MCP 协议的 Android ADB 服务器，允许通过 Claude for Desktop 或其他 MCP 客户端远程控制连接到电脑的 Android 设备。
## 功能特点
设备管理：列出已连接的 Android 设备
屏幕操作：截图、点击、滑动（上下左右）
输入操作：文本输入、按键模拟
应用管理：安装/卸载应用、启动应用
系统操作：获取屏幕分辨率等设备信息
网络工具：获取网络状态、端口扫描、WIFI管理
文件工具：文件上传/下载、文件管理
高级工具：UI测试、性能分析、录屏、日志收集、增强型启动应用
## 前提条件
1. Python 3.10 或更高版本
2. ADB 已安装并添加到系统路径
3. Android 设备已启用 USB 调试并连接到电脑
## 安装
bash
# 克隆此仓库
git clone https://github.com/wolfcoming/adbmcpserver.git
cd adbmcpserver
# 安装依赖
pip install -r requirements.txt
# 确保 ADB 服务器已启动
adb start-server
## 使用方法
### 在 Claude for Desktop 中配置
1. 安装 Claude for Desktop
2. 配置 MCP 服务器:
找到 Claude for Desktop 配置文件，通常在 ~/Library/Application Support/Claude/claudedesktopconfig.json
添加以下配置:
json
"mcpServers": {
"androidadb": {
"command": "python",
"args": [
"-m",
"src.adbserver"
],
"cwd": "/path/to/adbmcpserver"
3. 重启 Claude for Desktop
### 在 Cursor 中配置
1. 找到 Cursor 配置文件，通常在 ~/.cursor/mcp.json
2. 添加以下配置:
json
"mcpServers": {
"androidadb": {
"command": "python",
"args": [
"-m",
"src.adbserver"
],
"cwd": "/path/to/adbmcpserver"
3. 重启 Cursor
## 支持的工具
### 设备管理
listdevices: 列出所有连接的 Android 设备
### 屏幕操作
takescreenshot: 截取设备屏幕
tapscreen: 点击屏幕上的指定位置
swipeup: 向上滑动
swipedown: 向下滑动
swipeleft: 向左滑动
swiperight: 向右滑动
### 输入操作
inputtext: 输入文本
presskey: 按下指定按键
pressback: 按下返回键
presshome: 按下 Home 键
### 应用管理
startapp: 启动应用
installapk: 安装APK
uninstallapp: 卸载应用
### 系统操作
getscreenresolution: 获取屏幕分辨率
### 网络工具
getipaddress: 获取设备IP地址
ping: 测试网络连接
scanports: 扫描指定端口
getwifistatus: 获取WIFI状态
connectwifi: 连接到WIFI网络
### 文件工具
listfiles: 列出目录下的文件
uploadfile: 上传文件到设备
downloadfile: 从设备下载文件
createfile: 创建文件
deletefile: 删除文件
### 高级工具
dumpuihierarchy: 获取界面层次结构
runuitest: 执行UI测试步骤
checkelementexists: 检查界面元素是否存在
tapelementbytext: 点击包含指定文本的UI元素
collectdevicelogs: 收集设备日志
analyzeperformance: 分析应用性能
takescreenrecording: 录制设备屏幕视频
enhancedstartapp: 增强型应用启动功能，可绕过权限限制
## 示例用法
在 Claude for Desktop 中，可以这样使用:
# 设备相关
"我想查看连接的 Android 设备"
"请截取我的 Android 设备屏幕"
# 应用操作
"请安装这个APK文件: /path/to/app.apk"
"请启动设置应用(com.android.settings)"
"请使用增强型启动功能打开中国新闻网应用，即使遇到权限问题"
# 输入与交互
"请点击屏幕坐标 (500, 500)"
"请在屏幕上从底部向上滑动"
"请点击包含'设置'文本的按钮"
# 文件操作
"请列出设备上 /sdcard/ 目录下的文件"
"请将设备上的 /sdcard/DCIM/pic.jpg 下载到我的电脑"
# 网络操作
"请检查设备的WIFI状态"
"请连接到名为'MyWifi'的网络"