Mobile MCP

社区

面向 iOS 与 Android 的移动端自动化测试 MCP 服务器,fork 自 qwen-code 并支持相对坐标定位。

分类: 开发工具第 394 / 438
Stars: ★ 29.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 今天

34FMRS · D

该条目是 qwen-code 仓库中一个用于移动端自动化测试的 MCP 服务器清单,以 npm 包形式通过 stdio 传输运行,是 mobile-mcp 项目的 fork 版本并新增了相对坐标支持。源材料未提供具体工具列表或客户端兼容性证据,因此这些字段留空;评估基于清单与仓库描述所能确认的事实。

最强项 · 维护活跃度 12/20 最弱项 · 文档质量 4/20

可靠性

6/20

安全与权限

7/20

维护活跃度

12/20

文档质量

4/20

安装易用性

5/20

查看各项评分依据

可靠性 6/20: manifest 仅声明了一个 npm 包（@qwen-code/mobile-mcp）和 stdio 传输方式，version 字段仍是未替换的模板占位符 {{VERSION}}，这本身就说明该清单未经过实际发布流程的校验。提供的材料中没有任何针对 mobile-mcp 这个子包的 CI 工作流、单元/集成测试、工具列表或握手行为证据；顶层仓库的活跃度不能替代对这个具体 server 的可复现性证明。按静态评审规则，没有可验证的执行证据，reliability 不得超过 12，考虑到连版本占位符都未解析、也没有任何工具清单或错误处理描述，只给较低分。
安全与权限 7/20: 移动设备自动化（iOS/Android 控制、UI 自动化测试）通常涉及 ADB/模拟器访问、应用安装卸载、屏幕操作等具有真实副作用的能力，但材料中没有任何权限模型、最小权限说明、危险操作确认机制或数据边界描述。该 server 被描述为“fork（带相对坐标支持）”，未说明分支的维护者身份或与原始项目的关系，也未披露网络/凭证使用方式。没有发现红线证据（恶意代码、凭证窃取等），但由于关键的权限与确认机制信息完全缺失，且涉及潜在高风险的设备操作，只能给中低分。
维护活跃度 12/20: qwen-code 主仓库 star 数高（26728）、issue 数量多（855 open），license 为 Apache-2.0，说明主项目本身维护活跃、治理相对清晰。但 mobile-mcp 是嵌在该 monorepo 下的一个子包（packages/mobile-mcp），材料中没有该子包专属的发布记录、版本历史或安全响应渠道的证据，其维护活跃度只能部分借助主仓库的信誉，无法独立验证。
文档质量 4/20: 提供的 README 是 qwen-code 顶层项目的通用介绍，全文未提及 mobile-mcp 或移动自动化能力，没有该 server 的安装步骤、工具参数、认证方式、限制说明或故障排除内容。manifest 本身也极其简略，只有包名和传输类型，没有任何使用示例。文档与该具体 server 的实际能力之间几乎没有对应关系，评分很低。
安装易用性 5/20: manifest 中除 npm 包标识符和 stdio 传输类型外没有提供任何客户端配置示例（如 args、env、client 配置片段），version 字段仍为未替换的占位符，说明该配置文件可能尚未定型或未经实际验证即可用。没有迹象表明主流 MCP 客户端（如 Claude Desktop）下可以直接照抄配置完成连接。按静态评审规则，没有可验证的执行证据时 setup 不得超过 15，而实际材料缺失到几乎没有安装信息的程度，只能给很低的分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

正在使用 qwen-code 或其他支持 MCP 的编程代理进行移动应用开发的团队
需要 AI 辅助进行 iOS/Android UI 自动化测试的开发者
希望利用相对坐标而非绝对坐标以提升跨设备兼容性的自动化场景

不适合谁

不涉及移动端开发或测试的通用编程任务
需要浏览器自动化、数据库操作或云存储集成的场景
无法提供或连接 iOS/Android 设备、模拟器环境的用户

所需权限

访问并控制本地或已连接的 iOS/Android 模拟器或真机
在设备上安装、启动、操作应用程序
捕获设备屏幕内容并发送触控/坐标输入

风险与副作用

该服务器为社区 fork 版本,可能与上游 mobile-mcp 项目的安全更新和缺陷修复不同步
赋予 AI 代理对移动设备的自动化控制权限,存在误操作导致设备数据丢失或应用状态异常的风险
源材料未列出具体工具清单,实际暴露的操作范围和权限边界不透明,需自行审查发布的包内容后再信任使用
运行未经过独立安全审计的第三方 npm 包,存在供应链风险

安装接入

准备工作

运行环境：Node.js

确保已安装 Node.js 22 及以上版本(qwen-code 主项目的要求)。
通过 npm 安装或直接以 npx 方式运行 @qwen-code/mobile-mcp 包(注册表:https://registry.npmjs.org)。
在支持 stdio 传输的 MCP 客户端配置文件中,将该服务器加入 mcpServers,指定 command 为 npx、args 为 ["-y", "@qwen-code/mobile-mcp"]。
确保本地已配置好 iOS 模拟器/真机或 Android 模拟器/真机及相应的调试工具(如 Xcode 命令行工具、adb),以便服务器可以连接并驱动移动设备。
重启或重新加载客户端以加载新的 MCP 服务器。

MCP 配置 · JSON

{"mcpServers":{"mobile-mcp":{"command":"npx","args":["-y","@qwen-code/mobile-mcp"]}}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qwen-code/mobile-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mobile-mcp -- npx -y @qwen-code/mobile-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中添加 mobile-mcp 服务器（npx -y @qwen-code/mobile-mcp），重启客户端后检查工具列表中是否出现 mobile-mcp 相关工具；也可以直接提问“列出已连接的移动设备”，若能返回设备信息即说明连接成功。

常见排障

确认 Node.js 版本满足 >=22.0.0 的要求
确认 @qwen-code/mobile-mcp 包已从 npm registry 正确安装,且 {{VERSION}} 占位符已被替换为具体版本号
检查 iOS/Android 模拟器或真机是否已正确连接,adb 或 Xcode 工具是否可用
检查 MCP 客户端的 stdio 传输配置是否正确指向该包的可执行入口

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前连接的 Android 设备并显示其状态。
帮我截取 iPhone 模拟器当前的屏幕。
在这台 Android 设备上安装 ./app-debug.apk 并启动应用。
点击应用登录页上的登录按钮。

使用场景

通过 AI 代理自动化操作 iOS/Android 模拟器或真机,执行 UI 交互测试

在 CI 或本地开发流程中让编程代理协助编写、运行和验证移动端自动化测试脚本

结合相对坐标定位能力,在不同分辨率/设备上更稳定地驱动 UI 元素

详细介绍

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 子包给出详细说明。