适合谁
- 正在使用 qwen-code 或其他支持 MCP 的编程代理进行移动应用开发的团队
- 需要 AI 辅助进行 iOS/Android UI 自动化测试的开发者
- 希望利用相对坐标而非绝对坐标以提升跨设备兼容性的自动化场景
I
io.github.qwenlm/mobile-mcp
社区
面向 iOS 与 Android 的移动端自动化测试 MCP 服务器,fork 自 qwen-code 并支持相对坐标定位。
GitHub 源仓库 ↗
34FMRS · D
该条目是 qwen-code 仓库中一个用于移动端自动化测试的 MCP 服务器清单,以 npm 包形式通过 stdio 传输运行,是 mobile-mcp 项目的 fork 版本并新增了相对坐标支持。源材料未提供具体工具列表或客户端兼容性证据,因此这些字段留空;评估基于清单与仓库描述所能确认的事实。
io.github.qwenlm/mobile-mcp 是 QwenLM/qwen-code 仓库中 packages/mobile-mcp 目录下的一个 MCP 服务器清单,用于 iOS 和 Android 移动应用的开发、自动化与测试。其描述明确说明这是一个 mobile-mcp 的 fork 版本,增加了相对坐标支持。该服务器以 npm 包 @qwen-code/mobile-mcp 的形式发布,通过 stdio 传输与客户端通信。源材料中未列出具体的工具(tools)清单,因此无法确认其暴露的具体能力名称。qwen-code 本身是一个开源的终端 AI 编程代理,支持多种模型协议(OpenAI、Anthropic、Gemini、Qwen)及 MCP 集成,但 README 主要围绕主 CLI 产品展开,未针对 mobile-mcp 子包给出详细说明。
工具能力
暂未整理工具清单。
安装接入
- 确保已安装 Node.js 22 及以上版本(qwen-code 主项目的要求)。2. 通过 npm 安装或直接以 npx 方式运行 @qwen-code/mobile-mcp 包(注册表:https://registry.npmjs.org)。3. 在支持 stdio 传输的 MCP 客户端配置文件中,将该服务器加入 mcpServers,指定 command 为 npx、args 为 ["-y", "@qwen-code/mobile-mcp"]。4. 确保本地已配置好 iOS 模拟器/真机或 Android 模拟器/真机及相应的调试工具(如 Xcode 命令行工具、adb),以便服务器可以连接并驱动移动设备。5. 重启或重新加载客户端以加载新的 MCP 服务器。
claude_desktop_config.json
{"mcpServers":{"mobile-mcp":{"command":"npx","args":["-y","@qwen-code/mobile-mcp"]}}}
选型与风险
不适合谁
- 不涉及移动端开发或测试的通用编程任务
- 需要浏览器自动化、数据库操作或云存储集成的场景
- 无法提供或连接 iOS/Android 设备、模拟器环境的用户
所需权限
- 访问并控制本地或已连接的 iOS/Android 模拟器或真机
- 在设备上安装、启动、操作应用程序
- 捕获设备屏幕内容并发送触控/坐标输入
风险与副作用
- 该服务器为社区 fork 版本,可能与上游 mobile-mcp 项目的安全更新和缺陷修复不同步
- 赋予 AI 代理对移动设备的自动化控制权限,存在误操作导致设备数据丢失或应用状态异常的风险
- 源材料未列出具体工具清单,实际暴露的操作范围和权限边界不透明,需自行审查发布的包内容后再信任使用
- 运行未经过独立安全审计的第三方 npm 包,存在供应链风险
常见排障
- 确认 Node.js 版本满足 >=22.0.0 的要求
- 确认 @qwen-code/mobile-mcp 包已从 npm registry 正确安装,且 {{VERSION}} 占位符已被替换为具体版本号
- 检查 iOS/Android 模拟器或真机是否已正确连接,adb 或 Xcode 工具是否可用
- 检查 MCP 客户端的 stdio 传输配置是否正确指向该包的可执行入口
使用场景
通过 AI 代理自动化操作 iOS/Android 模拟器或真机,执行 UI 交互测试
在 CI 或本地开发流程中让编程代理协助编写、运行和验证移动端自动化测试脚本
结合相对坐标定位能力,在不同分辨率/设备上更稳定地驱动 UI 元素
支持客户端
暂未确认支持的客户端。