Android MCP Tool

Android MCP Tool 是一个基于 FastMCP 框架开发的安卓设备管理工具，通过 ADB 与安卓设备进行交互，提供丰富的设备操作功能。

作者信息

• GitHub: OxenFxc
• 哔哩哔哩: DifierLine

版本信息

• 当前版本: 1.0.0
• 发布日期: 2026-01-07

功能特性

1. 设备管理

• 获取已连接的设备列表
• 获取设备详细信息
• 获取设备系统属性
• 获取设备屏幕分辨率和密度信息
• 检查设备连接状态

2. APK 管理

• 安装 APK 文件到设备
• 卸载设备上的应用程序
• 获取已安装的应用包名列表
• 获取指定应用包的信息
• 清除应用数据和缓存
• 启动和停止应用

3. 文件传输

• 从电脑推送文件到安卓设备
• 从安卓设备拉取文件到电脑
• 列出设备上的目录内容
• 在设备上创建目录
• 删除设备上的文件或目录

4. Shell 命令执行

• 执行任意 Shell 命令
• 获取设备系统信息
• 获取设备进程列表
• 获取和清除设备日志
• 重启设备

5. 屏幕截图与录制

• 截取设备屏幕截图
• 录制设备屏幕视频
• 获取设备屏幕密度
• 获取和设置设备屏幕分辨率

项目结构

android_mcp/
├── core/
│   ├── __init__.py
│   └── adb.py              # ADB 基础工具类
├── tools/
│   ├── __init__.py
│   ├── device_manager.py   # 设备管理工具
│   ├── apk_installer.py    # APK 安装工具
│   ├── file_transfer.py    # 文件传输工具
│   ├── shell_executor.py   # Shell 执行工具
│   └── screenshot.py       # 屏幕截图工具
├── server.py               # FastMCP 服务器入口
├── mcp.json               # MCP 配置文件
└── __init__.py

使用方法

1. 安装依赖

pip install fastmcp

2. 配置 MCP

编辑 mcp.json 文件，将 PYTHONPATH 替换为 android_mcp 目录的实际路径：

{
  "mcpServers": {
    "AndroidMCP": {
      "command": "python",
      "args": [
        "-m",
        "android_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "C:\\Users\\ruilo\\Documents\\TRAE"
      }
    }
  }
}

可用工具列表

工具函数	功能描述
get_connected_devices	获取已连接的设备列表
get_device_info	获取指定设备的详细信息
get_device_properties	获取设备的系统属性
get_device_screen_info	获取设备屏幕分辨率和密度信息
check_device_connection	检查设备连接状态
install_apk	安装 APK 文件到设备
uninstall_app	卸载设备上的应用程序
get_installed_packages	获取已安装的应用包名列表
get_package_info	获取指定应用包的信息
clear_app_data	清除应用数据和缓存
start_app	启动应用
stop_app	停止应用
push_file	从电脑推送文件到安卓设备
pull_file	从安卓设备拉取文件到电脑
list_remote_directory	列出设备上的目录内容
create_remote_directory	在设备上创建目录
delete_remote_file	删除设备上的文件或目录
execute_shell_command	执行 Shell 命令
get_system_info	获取设备系统信息
get_process_list	获取设备进程列表
get_logcat	获取设备日志
clear_logcat	清除设备日志
reboot_device	重启设备
take_screenshot	截取设备屏幕截图
record_screen	录制设备屏幕
get_screen_density	获取设备屏幕密度
get_screen_resolution	获取设备屏幕分辨率
set_screen_resolution	设置设备屏幕分辨率

参数说明

所有工具函数都支持以下可选参数：

• serial: 设备序列号。如果省略，将自动使用第一个已连接的设备。
• timeout: 命令执行超时时间（秒），默认 30 秒。

使用示例

# 获取已连接的设备列表
devices = get_connected_devices()

# 安装 APK（使用第一个设备）
result = install_apk("path/to/app.apk")

# 指定设备安装 APK
result = install_apk("path/to/app.apk", serial="device_serial")

# 推送文件到设备
push_file("local/path/file.txt", "/sdcard/file.txt")

# 执行 Shell 命令
result = execute_shell_command("ls -la /sdcard")

# 截取屏幕截图
take_screenshot("screenshot.png")

系统要求

• Python 3.8+
• ADB 工具（Android SDK Platform Tools）
• FastMCP

许可证

本项目可以自由使用、修改和分发，但必须在项目中明确标注原作者信息。

致谢

感谢所有使用和支持本项目的用户。