QApilot MCP for Android 将 AI 编程客户端连接至本地 Android 设备，无需手动编写 Appium 代码即可执行自然语言测试用例，简化自动化流程。
产品用途与官方定位
QApilot MCP for Android 是一款基于模型上下文协议（Model Context Protocol）的命令行桥接工具，允许 Claude Desktop 和 Cursor 等 AI 助手直接驱动移动应用测试。它能够直接连接本地 Appium 服务器与 Android Debug Bridge（ADB）环境，无需用户手动编写 Appium 或 UIAutomator 脚本即可操控物理设备与模拟器。
该工具通过将对话式提示词转换为结构化执行计划来自动化测试工作流，执行手动交互操作，并将实时执行画面流式传输至浏览器预览窗口，同时将验证通过的测试路径保存回 QApilot 项目。测试运行结束后，它会输出结构化测试数据、Gherkin 规范文件以及会话指标。
有官方来源支持的使用场景
质量工程师可以使用自然语言描述测试交互流程，由 AI 客户端构建结构化测试计划，在已连接的 Android 设备上执行操作并自动捕获屏幕截图。
团队可以按 ID 顺序回放先前已验收的测试用例，或者直接从 Excel（.xlsx）电子表格中批量加载并针对连接的模拟器执行完整测试套件。
官网提供的使用流程
确认本地环境满足先决条件，包括 Node.js 18+、Java JDK 11+、Android SDK，并启动带有指定 uiautomator2 驱动的 Appium 2.19.0 服务。
在 Claude Desktop、Cursor 或其他兼容的 AI 客户端 MCP 设置配置文件中添加 qapilot-mobile-mcp 命令及其运行参数。
登录 QApilot 工作区，并通过指定目标应用的 Android 软件包标识符（Package ID）在设备上启动应用。
指导 AI 助手执行测试操作，通过实时预览流查看执行进度，并将验证成功的理想路径步骤保存至 QApilot。
生成完整的会话测试报告，输出 JSON、YAML 和 Gherkin 格式文件，同时清除当前执行状态以供后续测试运行。
该命令行工具作为通过标准输入和输出流进行通信的 MCP 服务器运行，公开了用于设备管理、测试计划构建、操作分发以及状态查询的专用工具集。AI 客户端利用诸如 mobile_launch_app、mobile_submit_plan 和 mobile_execute 等工具，以编程方式全面管理 Appium 会话生命周期。
在活跃执行期间，状态检查命令允许客户端查询当前执行状态并获取缓存的应用技能与 XPath 定位符。当测试运行结束时，调用报告工具会将测试产物保存在本地的 Downloads 目录中，并重置当前的活跃执行上下文。
用自己的素材和工作流完成验证
核对了哪些信息以及核对时间
基于已核对产品资料的回答
该服务器可以配置在 Claude Desktop、Cursor、OpenAI Codex 或任何兼容模型上下文协议（Model Context Protocol）的 AI 工具中进行协同工作。
官方文档明确要求本地安装 Appium 2.19.0 版本，并配合使用 4.2.6 版本的 uiautomator2 自动化驱动程序。
不能，系统仅接受并保存测试成功的理想路径（Happy-path）步骤；执行失败的步骤会被排除，必须在修复解决后方可保存为测试用例。
测试报告默认保存至用户的 Downloads 目录中，内容包括 output.json、report.yaml，以及针对测试通过会话生成的 scenario.feature 格式 Gherkin 文件。
支持，用户可以使用 mobile_run_excel_testcases 工具直接从 Excel（.xlsx）文件中批量读取并执行已保存的回归测试用例。
