Metadata-Version: 2.4
Name: iflow-mcp_wolfcoming-adb_mcp_server
Version: 1.0.0
Summary: Android ADB MCP Server - Control Android devices via MCP protocol
Project-URL: Homepage, https://github.com/wolfcoming/adb_mcp_server
Project-URL: Repository, https://github.com/wolfcoming/adb_mcp_server
Project-URL: Issues, https://github.com/wolfcoming/adb_mcp_server/issues
Author-email: wolfcoming <wolfcoming@github.com>
License: MIT
License-File: LICENSE
Keywords: adb,android,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: pure-python-adb
Description-Content-Type: text/markdown

# Android ADB MCP 服务器

![GitHub](https://img.shields.io/github/license/wolfcoming/adb_mcp_server)
![GitHub stars](https://img.shields.io/github/stars/wolfcoming/adb_mcp_server)
![GitHub last commit](https://img.shields.io/github/last-commit/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/adb_mcp_server.git
cd adb_mcp_server

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

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

## 使用方法

### 在 Claude for Desktop 中配置

1. 安装 [Claude for Desktop](https://claude.ai/desktop)
2. 配置 MCP 服务器:
   - 找到 Claude for Desktop 配置文件，通常在 `~/Library/Application Support/Claude/claude_desktop_config.json`
   - 添加以下配置:

```json
{
    "mcpServers": {
        "android_adb": {
            "command": "python",
            "args": [
                "-m",
                "src.adb_server"
            ],
            "cwd": "/path/to/adb_mcp_server"
        }
    }
}
```

3. 重启 Claude for Desktop

### 在 Cursor 中配置

1. 找到 Cursor 配置文件，通常在 `~/.cursor/mcp.json`
2. 添加以下配置:

```json
{
    "mcpServers": {
        "android_adb": {
            "command": "python",
            "args": [
                "-m",
                "src.adb_server"
            ],
            "cwd": "/path/to/adb_mcp_server"
        }
    }
}
```

3. 重启 Cursor

## 支持的工具

### 设备管理
- `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`: 增强型应用启动功能，可绕过权限限制

## 示例用法

在 Claude for Desktop 中，可以这样使用:

```
# 设备相关
"我想查看连接的 Android 设备"
"请截取我的 Android 设备屏幕"

# 应用操作
"请安装这个APK文件: /path/to/app.apk"
"请启动设置应用(com.android.settings)"
"请使用增强型启动功能打开中国新闻网应用，即使遇到权限问题"

# 输入与交互
"请点击屏幕坐标 (500, 500)"
"请在屏幕上从底部向上滑动"
"请点击包含'设置'文本的按钮"

# 文件操作
"请列出设备上 /sdcard/ 目录下的文件"
"请将设备上的 /sdcard/DCIM/pic.jpg 下载到我的电脑"

# 网络操作
"请检查设备的WIFI状态"
"请连接到名为'MyWifi'的网络"

# 高级功能
"请分析'com.example.app'应用的性能，持续30秒"
"请录制10秒钟的屏幕视频"
"请收集最近的设备日志"
```

## 提示

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

## 贡献

欢迎提交问题和贡献代码！请随时提交 Pull Request 或创建 Issue。

## 许可证

MIT © [wolfcoming](https://github.com/wolfcoming) 