Android MCP

🚀 🤖 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 设备

🏁 开始安装

1. 克隆仓库

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

2. 安装依赖项

uv python install 3.10
uv sync

3. 连接到 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},
}