cloudphone

📱 云端 Android 自动化测试助手

基于 mcporter 与 cpc-mcp-server 的云手机自动化方案,支持 AutoJS 脚本远程执行与批量测试,适用于 Android 应用回归验证与 UI 自动化场景。

收藏
9.6k
安装
3.1k
版本
v0.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Cloud Phone Agent 是一个面向云手机环境的自动化测试 Skill,通过 mcporter CLI 工具桥接 cpc-mcp-server MCP 服务器,实现远程 Android 设备的 AutoJS 脚本执行与任务编排。其核心用法围绕 createAutoJsAgentTask 工具展开,用户只需提供目标应用、操作指令、成功标准和期望输出,即可在云手机实例上完成从登录验证、页面导航到截图留证的全流程自动化。

该 Skill 的显著优点在于完全云端化执行,无需本地配置 Android 模拟器或连接实体设备,极大降低了自动化测试的环境门槛。支持批量任务派发和远程并发执行,适合回归测试和冒烟测试场景。同时,认证机制采用环境变量注入方式,避免了密钥硬编码带来的泄露风险,符合安全开发规范。

然而,该方案也存在一定局限性。首先,它严格限定于云端 Android 环境,不支持本地 ADB 调试或 iOS 设备自动化。其次,执行过程高度依赖外部 mcporter 工具链和 cpc-mcp-server 服务的稳定性,网络延迟或服务中断将直接影响任务可靠性。此外,作为 T3 级个人开发者维护的项目,长期更新和维护的可持续性有待观察。

该 Skill 最适合移动应用测试工程师、QA 团队以及需要远程验证 Android 应用流程的开发者。对于需要在多设备、多系统版本上进行兼容性验证,或希望在 CI/CD 流水线中集成自动化测试的企业用户尤为适用。但本地开发调试场景或 iOS 生态的用户需寻求其他替代方案。

使用过程中需关注以下风险:API Key 的管理需严格遵循环境变量配置规范,避免意外提交至代码仓库;远程 MCP 服务器的通信需确保 HTTPS 加密和证书有效性,防范中间人攻击;云手机执行环境的隔离性和数据残留问题需在敏感业务场景下额外评估;任务执行结果(截图、日志)的传输和存储应符合数据合规要求。

安全解读

核心用法

cloudphone 是一个指导型 Skill,本身不直接执行代码,而是通过 mcporter CLI 工具调用 cpc-mcp-server 的 AutoJS Agent 工具,实现云端 Android 设备的自动化任务。主要工作流程:

1. 前置配置:设置 CLOUDPHONE_API_KEY 环境变量,确保 MCP 服务器认证头部注入
2. 任务创建:使用 mcporter call cpc-mcp-server.createAutoJsAgentTask 创建 AutoJS 任务,需提供目标应用、执行指令、成功标准和期望输出

3. 结果获取:通过返回的 taskId 追踪任务状态,获取截图、日志或文本结果

典型命令模式:

mcporter call cpc-mcp-server.createAutoJsAgentTask --args '{"instruction": "打开 XX 应用并截图", "lang": "zh"}'

显著优点

  • 零代码风险:纯 Markdown 文档型 Skill,无可执行代码,无动态加载,静态分析满分
  • 架构清晰:遵循 MCP 协议标准,通过 mcporter 解耦调用,符合现代 AI 工具链设计
  • 安全实践良好:强制环境变量管理 API 密钥,明文禁止硬编码,符合企业密钥管理规范
  • 功能边界明确:文档清晰界定适用场景(云端 Android/AutoJS)与禁用场景(本地 ADB/iOS)
  • 合规达标:通过 GDPR 数据最小化、CCPA 知情权、无硬编码凭证等 6 项合规检测

潜在缺点与局限性

  • T3 来源等级:维护者 sav7ng 为个人开发者,虽账号历史 10 年且关注者 148,但非企业背书
  • 依赖外部链条:实际执行依赖 mcporter CLI 和 cpc-mcp-server 两个上游组件,Skill 本身无法控制其安全更新
  • 未声明许可证:当前版本无开源许可证,商业使用存在法律不确定性
  • 无动态分析验证:T-MD 分类跳过动态行为分析,无法验证运行时实际行为
  • 网络透明度有限:仅声明无外部 API 调用,但 cpc-mcp-server 的实际服务端通信细节未披露

适合人群

  • 需要进行云手机自动化测试的 QA 工程师
  • 使用 AutoJS 进行 Android 批量操作的技术团队
  • 已部署 cpc-mcp-server 基础设施的企业用户
  • 熟悉 MCP 协议和命令行工具的开发人员

常规风险

1. 上游供应链风险:mcporter 或 cpc-mcp-server 若存在漏洞,可能影响整体安全
2. API 密钥泄露:虽文档禁止硬编码,但用户实际使用仍可能误操作导致密钥暴露

3. 云服务商依赖:任务执行依赖第三方云手机服务商的可用性和数据安全策略

4. 功能漂移风险:MCP 服务器接口变更可能导致 Skill 指导失效

cloudphone 内容

手动下载zip · 2.8 kB
mcporter-readme.mdtext/markdown
请选择文件