mobile-mcp 完整上手一个 MCP 服务器跑通 iOS 与 Android 手机自动化【免费下载链接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)项目地址: https://gitcode.com/GitHub_Trending/mo/mobile-mcpmobile-mcp 是一个基于 MCP 协议的移动端自动化服务器一条 npx 命令接入 AI 客户端后iOS、Android 的模拟器和真机都能用同一组指令驱动点击、滑动、输入、装包、抓崩溃日志不再为两个平台各写一套脚本。想让 AI 替你按手机的时候假设你要验证一个新版本 App 的注册流程。传统做法是打开 XCUITest 或 Espresso 项目写用例、找控件、跑一遍再看日志如果 App 换了页面结构脚本又要改。mobile-mcp 把这件事换成了另一条路你启动模拟器把服务器配进 Cursor、Claude Code、Codex 这类客户端然后用一句自然语言描述帮我下载一个番茄钟应用、注册、启动计时器剩下的交给 Agent 自己点。它适合两类人一是想让 LLM 直接操作手机的开发者二是需要跨 iOS/Android 复测同一条流程的测试同学。它是什么和已有方案差在哪mobile-mcp 是一个 MCP Server跑在 npm 上包名mobilenext/mobile-mcp底层用自研的 Device Kit 接管设备而不是传统的 WebDriverAgent。它暴露 30 来个mobile_前缀的工具同一套工具同时覆盖 iOS 模拟器/真机和 Android 模拟器/真机。和 XCUITest、Espresso 这类框架的最大区别是你写的是目标不是控件定位表达式。四组能力按需取用能力模块具体工具解决的问题典型场景设备管理mobile_list_available_devices、mobile_get_screen_size、mobile_set_orientation、mobile_set_location不用记 adb/simctl 命令就能查设备、改方向、伪造 GPS写用例前确认设备状态应用管理mobile_launch_app、mobile_install_app、mobile_get_foreground_app直接按包名装、启、停 App回归测试前装新版安装包屏幕交互mobile_list_elements_on_screen、mobile_click_on_screen_at_coordinates、mobile_swipe_on_screen、屏幕录制优先读无障碍树拿元素和坐标读不到才回退截图多步 UI 流程自动化排障工具mobile_get_device_logs、mobile_list_crashes、mobile_batch_commands一次调用连跑多个动作App 崩了能直接取崩溃报告复现 Bug 并留存证据两个值得留意的细节元素列表里的每个元素带一个稳定的ref标识Agent 可以直接按 ref 点按不用自己算坐标无障碍树优先意味着大部分操作不消耗图像 token成本和速度都比纯截图方案省。三步把环境跑起来第 1 步装平台工具确认设备能连上Android 侧装 Android Platform Tools让adb在 PATH 里iOS 侧macOS装 Xcode 命令行工具Node.js 需要 v20确认方法adb devices # Android能看到设备或 emulator 即可 xcrun simctl list # iOS能看到已创建的模拟器 node --version # v20 以上然后启动一个目标Android 用avdmanager/emulator启动仿真器iOS 用xcrun simctl boot iPhone 16。第 2 步把服务器加进 MCP 客户端大多数客户端用同一份配置仓库里现成的 mcp.json 就是它{ mcpServers: { mobile-mcp: { command: npx, args: [-y, mobilenext/mobile-mcplatest] } } }各客户端也有快捷方式例如 Claude Codeclaude mcp add mobile-mcp -- npx -y mobilenext/mobile-mcplatest第 3 步验证链路通了在对话里直接说list available devices如果返回了你正在运行的模拟器、仿真器或真机链路就是通的返回空列表基本只有一个原因——没有设备处于启动/连接状态。服务端代码在 src/ 下按平台分了模块android.ts、ios.ts、iphone-simulator.ts想深挖行为时可以直接看。两个拿来就能用的例子例子 1让 Agent 走一遍完整的下载—注册—评分流程README 里给过这类提示词直接可用找一个评分超过 1k 星的免费 Pomodoro 应用并下载。 启动应用用我的邮箱注册。注册完成后找到如何启动番茄钟计时器。 计时器启动后回到应用商店给这个应用打 5 星并写一条评论。一句话覆盖了搜索、下载、启动、填表、切回商店、评分五类操作。Agent 每点一步都会重新列一次屏幕元素确认状态不会盲点。例子 2复现崩溃并把证据拿回来让 Agent 跑一段容易崩的流程然后复现刚才的崩溃后把设备日志和崩溃报告都取出来对应mobile_get_device_logsAndroid 取 logcatiOS 取 unified log和mobile_list_crashes/mobile_get_crash不用自己插线翻目录。多步操作还可以用mobile_batch_commands一次调用串起来比如点击、输入、再点击省掉多次往返。选型对比与容易踩的坑维度mobile-mcpXCUITest / Espresso纯截图的视觉 Agent平台覆盖一套工具四个目标一套对应一个平台通用但依赖模型能力输入方式自然语言代码 控件定位自然语言元素读取无障碍树优先截图兜底控件树截图上手成本加一段 MCP 配置搭两套测试工程调提示词稳定性来源结构化数据 确定性操作断言模型判断几个实际用下来容易踩的坑设备列表为空九成是模拟器没 boot 或真机没授权。先跑adb devices/xcrun simctl list确认再怀疑服务器。点按落点偏了点元素边界框的中心别用左上角坐标输入前先点一下输入框确认获得焦点再mobile_type_keys。UI 动画没结束就操作移动端页面有过渡动画操作后重新列一次元素确认等预期元素出现再继续参考 skills/mobile-automation/SKILL.md 里的工作流。遥测默认开启介意就加环境变量MOBILEMCP_DISABLE_TELEMETRY1。iOS 真机比模拟器麻烦模拟器零额外配置真机要走 USB 信任 配对流程细节看 llms-install.md。另外如果要通过网络而不是 stdio 连客户端加--listen 3000起 Streamable HTTP 服务再配MOBILEMCP_AUTH设 Bearer 令牌即可详见 README.md 的 Streamable HTTP Server Mode 一节。后续规划的功能文件读写、WebView 支持、Flutter 控件树等可以翻 ROADMAP.md 看状态。mobile-mcp 本质上是把手机操作变成 AI 客户端里的一组普通工具你只需要描述目标。下一步建议先开一个模拟器配上 MCP用list available devices验证链路然后从例子 2 的崩溃复现跑起来——它最短也最容易看出效果。【免费下载链接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)项目地址: https://gitcode.com/GitHub_Trending/mo/mobile-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考