金大哥 - android-mcp MCP 详情

article

README

🚀 🤖 Android MCP

Android-MCP 是一个轻量级的开源桥梁，用于连接 AI 智能体和 Android 设备。它以 MCP 服务器的形式运行，能让大语言模型智能体执行诸如应用导航、UI 交互和自动化 QA 测试等实际任务，且无需依赖传统的计算机视觉流程或预编程脚本。

https://github.com/user-attachments/assets/cf9a5e4e-b69f-46d4-8487-0f61a7a86d67

🚀 快速开始

Android-MCP 是连接 AI 智能体与 Android 设备的关键工具。以下将详细介绍如何安装和配置它，以便你能尽快开始使用。

✨ 主要特性

原生 Android 集成
通过 ADB 和 Android 辅助功能 API 与 UI 元素进行交互，可实现启动应用、点击、滑动、输入文本以及读取视图层次结构等操作。
支持自定义大语言模型/视觉语言模型
可与任何语言模型配合使用，无需微调的计算机视觉模型或 OCR 流程。
丰富的移动自动化工具集
提供预构建的工具，用于处理手势、按键、屏幕捕获、设备状态以及执行 shell 命令。
实时交互
根据设备规格和负载情况，操作（如两次点击）之间的典型延迟范围为 2 - 4 秒。

支持的操作系统

Android 10 及以上版本

📦 安装指南

📦 前提条件

Python 3.10 及以上版本
UIautomator2
Android 模拟器/Android 设备

🏁 开始安装

克隆仓库

git clone https://github.com/CursorTouch/Android-MCP.git
cd Android-MCP

安装依赖项

uv python install 3.10
uv sync

连接到 MCP 服务器
1. 找到你的 Claude Desktop 配置文件：
  - Windows：%APPDATA%\Claude\claude_desktop_config.json
  - macOS：~/Library/Application Support/Claude/claude_desktop_config.json
2. 将以下 JSON 添加到你的 Claude Desktop 配置中：

{
    "mcpServers": {
        "android-mcp": {
            "command": "path/to/uv",
            "args": [
                "--directory",
                "path/to/Android-MCP",
                "run",
                "main.py",
                "--emulator"
            ]
        }
    }
}

替换以下内容：
- `path/to/uv` 替换为你的 uv 可执行文件的实际路径
- `path/to/Android-MCP` 替换为你克隆此仓库的绝对路径

注意：`--emulator` 用于在模拟器中运行，若要使用实际设备，请移除该参数。

3. 重启 Claude Desktop 打开你的 Claude Desktop，“android-mcp” 现在应该会作为一个集成项出现。

如需查看故障排除提示（日志位置、常见 ADB 问题），请参阅 MCP 文档。

💻 使用示例

Claude 可以使用以下工具与 Android 设备进行交互：

State-Tool：了解设备的状态。
Click-Tool：在给定坐标处点击屏幕。
Long-Click-Tool：在给定坐标处长按屏幕。
Type-Tool：在指定坐标处输入文本（可选择清除现有文本）。
Swipe-Tool：从一个位置滑动到另一个位置。
Drag-Tool：从一个点拖动到另一个点。
Press-Tool：按下移动设备上的按键（返回、音量增大等）。
Wait-Tool：暂停指定的持续时间。
State-Tool：获取活动应用和交互式 UI 元素的组合快照。
Notification-Tool：访问设备上显示的通知。
Shell-Tool：在 Android 设备上执行 shell 命令。

⚠️ 重要提示

⚠️ 重要提示

Android-MCP 可以在你的移动设备上执行任意 UI 操作。在运行不可信的提示或智能体时，请在受控环境（模拟器、测试设备）中使用。

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。

🤝 贡献说明

欢迎贡献代码！请阅读 CONTRIBUTING 了解开发环境设置和 PR 指南。

由 Jeomon George 用心打造

引用

@misc{
  author       = {Jeomon George},
  title        = {Android-MCP},
  year         = {2025},
  publisher    = {GitHub},
  howpublished = {\url{https://github.com/CursorTouch/Android-MCP}},
  note         = {Lightweight open-source bridge between LLM agents and Android},
}

android-mcp