MCP Android Agent - FindMCP.info

Overview

基本能力

mcp-android-server-python 是一个用于 Android 设备自动化的 MCP 服务器，旨在通过自然语言控制 Android 设备，适用于 AI 代理、远程设备控制、自动化测试等场景。

工具名称	描述
`mcp_health`	检查 MCP 服务器是否正常运行
`connect_device`	连接 Android 设备并获取基本信息
`get_installed_apps`	列出所有已安装应用及其版本和包信息
`get_current_app`	获取当前前台应用的信息
`start_app`	通过包名启动应用
`stop_app`	通过包名停止应用
`stop_all_apps`	停止所有正在运行的应用
`screen_on`	打开屏幕
`screen_off`	关闭屏幕
`get_device_info`	获取详细设备信息（序列号、分辨率、电池等）
`press_key`	模拟硬件按键（如 `home`、`back`、`menu` 等）
`unlock_screen`	解锁屏幕（打开并滑动）
`check_adb`	检查 ADB 是否安装并列出连接的设备
`wait_for_screen_on`	异步等待直到屏幕打开
`click`	通过 `text`、`resourceId` 或 `description` 点击元素
`long_click`	长按元素
`send_text`	在当前聚焦的字段中输入文本（可选清除）
`get_element_info`	获取 UI 元素信息（文本、边界、可点击性等）
`swipe`	从一个坐标滑动到另一个坐标
`wait_for_element`	等待元素出现在屏幕上
`screenshot`	从设备上捕获并保存截图
`scroll_to`	滚动直到指定元素可见
`drag`	将元素拖拽到指定屏幕位置
`get_toast`	获取屏幕上最后显示的 toast 消息
`clear_app_data`	清除指定应用的用户数据/缓存
`wait_activity`	等待直到特定活动出现

git clone https://github.com/nim444/mcp-android.git
cd mcp-android

# 使用 uv (https://github.com/astral-sh/uv)
uv venv
source .venv/bin/activate  # Windows: .venv\\Scripts\\activate

uv pip install

uvicorn server:app --factory --host 0.0.0.0 --port 8000

python server.py

uv pip install uiautodev

uiauto.dev