Android-MCP：基于 ADB 的 Android 设备 MCP 控制服务器

获取下载链全程约 1 分钟

打开微信，搜索「软件教程管家」关注，或长按下方二维码关注
回复关键词 Android-MCP
公众号自动回复网盘链接，点击即可保存下载

Android-MCP：基于 ADB 的 Android 设备 MCP 控制服务器

打开微信扫一扫关注
或搜索【软件教程管家】

Android-MCP 是一个基于 Python 和 ADB 的 MCP Server，让支持 MCP 的 AI Agent 通过标准工具接口操作 Android 真机或模拟器。它覆盖设备选择、界面快照、点击、输入、滑动与等待等自动化操作，而且不需要在设备上安装项目自身的组件，适合开发、调试和自动化流程使用。

项目名称	Android-MCP
项目类型	MCP Server（Android 设备控制）
开发语言	Python
运行要求	Python 3.13、Android platform-tools 中的 adb
连接方式	USB、Wi-Fi、设备序列号、host:port
设备端安装	无需安装项目自身组件
仓库地址	https://github.com/CursorTouch/Android-MCP
Stars	921（采集时数据）

核心功能

通过 MCP stdio 接口暴露 Android 设备操作能力，方便接入支持 MCP 的客户端。
使用 adb 与设备通信，设备端无需安装项目自身组件，也不依赖 uiautomator2。
提供界面快照、元素标签、点击坐标和可选视觉标注，帮助定位交互元素。
支持按文本、资源 ID、类名或描述精确选择元素，并可指定匹配索引。
支持 USB、Wi-Fi、设备序列号和 host:port 等多种设备连接方式，并提供设备列表与连接管理工具。
覆盖触控、输入、系统按键、通知栏操作和条件等待等常见自动化动作。

安装与配置步骤

准备 Python 3.13 环境，确认版本符合运行要求，较旧的 Python 环境不在已给出的运行前提内。
安装 Android platform-tools，确保 adb 可用，并在电脑上能正常识别目标设备。
从 GitHub 仓库获取项目代码，按仓库 README 完成依赖安装与启动配置。
在 MCP 客户端中配置 stdio 服务，指向本项目的启动方式，完成客户端与服务的对接。
在 Android 设备上开启 USB 调试，用 USB 或 Wi-Fi 连接电脑，执行 adb devices 确认设备已列出。
先用设备列表工具确认目标设备，再试一次快照加点击的最小流程，确认选择器定位稳定后再跑完整自动化。

使用前必改的 5 项设置

固定设备选择方式：多设备环境下优先明确指定设备序列号，避免默认选中错误的设备。
确认输入方案：默认 Type 工具主要支持可打印 ASCII，部分带重音拉丁字符可用，其他文字需要 ADBKeyboard，提前决定是否启用这个外部应用。
选择器优先用资源 ID：文本匹配容易受界面文案变化影响，资源 ID 更稳定，复杂界面先验证定位效果。
Wi-Fi 连接单独确认：走 ADB over Wi-Fi 前，先确认设备的 ADB 网络可达性，不要默认局域网直连一定能通。
输入法恢复预案：启用 ADBKeyboard 会短暂切换设备输入法，提前记好用 adb shell ime reset 恢复默认输入法的方法。

注意事项

项目要求 Python 3.13 和可用的 adb，较旧的 Python 环境不在已给出的运行前提内，升级或部署前先核对版本。
Type 工具原生主要支持 ASCII 输入，非 ASCII 文字可能需要 ADBKeyboard，而该应用不由本项目打包。
ADBKeyboard 是可选的外部应用，启用后会短暂切换设备输入法，异常中断后可能需要手动重置输入法。
选择器点击要求精确匹配，复杂或动态界面能否稳定定位，需要结合具体应用界面验证。
公开信息有限，更完整的错误处理、权限要求和长期维护状态，需要查看 README 或源码确认。
设备通常在首次工具调用时才建立连接，正式采用前重点验证 Python 版本、设备连接、界面选择器稳定性以及非 ASCII 文本输入。

适合谁用

适合需要让 AI Agent 通过 MCP 操作 Android 真机或模拟器的开发者、自动化测试人员，以及正在搭建 Android 设备控制工作流的工程团队。它的取舍很明确：换来的是设备端零安装和标准 MCP 接口，代价是输入以 ASCII 为主、选择器依赖精确匹配、复杂跨应用的元素语义和高级测试编排能力有限。如果需求依赖复杂的跨应用元素语义、稳定的高级测试编排、广泛的设备兼容性，或不允许使用外部输入法组件，应先查看源码，并与专用的 Android 自动化框架对比验证后再决定。