Mobile QA Helper

QA Prompts MCP 服务

一个 MCP（Model Context Protocol）服务，为移动自动化团队提供 QA 提示词模板。它提供用于自动化代码生成、故障分析和缺陷标准化的结构化提示词和工具——可直接在 Cursor 中使用。

快速开始（无需克隆）

将以下内容添加到 Cursor MCP 配置文件（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "qa-prompts": {
      "command": "npx",
      "args": ["-y", "github:swapnilGirishPawar/Custom-MCP-Server-Mobile-QA"]
    }
  }
}

重启 Cursor。之后即可在聊天中通过 / 斜杠命令立即使用这些提示词。

此服务还通过 MCP 工具提供相同的功能，可由 MCP 客户端调用（启用工具调用后，Cursor 也可能自动使用这些工具）。

可用提示词（斜杠命令）

1. 手动测试 → 自动化转换

提示词	功能
/convert-manual-to-automation	将手动测试用例转换为遵循 POM 架构的 Appium + Java + TestNG 自动化脚本
/refactor-automation-code	深入评审现有自动化代码的 PR，并生成结构化评审报告
/xml-to-pom-locators	将 Appium Inspector Page Source XML 转换为 POM 定位器声明（优先级：ID > Accessibility > XPath）

2. 调试与故障分析

提示词	功能
/analyze-test-failure	分析 Appium 测试失败日志，以确定根本原因、严重程度、易发生不稳定的风险以及修复建议

3. 缺陷标准化

提示词	功能
/standardize-bug-report	根据组织模板，将缺陷标题/描述转换为标准化缺陷报告

可用工具（MCP 工具）

每个提示词也都注册为同名 MCP 工具（不带开头的 /）。

工具	功能
convert-manual-to-automation	将手动测试用例转换为遵循 POM 架构的 Appium + Java + TestNG 自动化脚本
refactor-automation-code	深入评审现有自动化代码的 PR，并生成结构化评审报告
xml-to-pom-locators	将 Appium Inspector Page Source XML 转换为 POM 定位器声明（优先级：ID > Accessibility > XPath）
analyze-test-failure	分析 Appium 测试失败日志，以确定根本原因、严重程度、易发生不稳定的风险以及修复建议
standardize-bug-report	根据组织模板，将缺陷标题/描述转换为标准化缺陷报告

注意：

• standardize-bug-report 工具输出：工具输出格式不包含 <Title> 行；它只返回 [Issue]、[Reproduction steps]、[Screenshot]、[Expected Result]（这些标题应为粗体）。

使用方法

1. 打开 Cursor 聊天（Cmd+L）或 Composer（Cmd+I）
2. 输入 / 查看可用提示词列表
3. 选择一个提示词
4. 填写所需输入
5. 提交——AI 会处理完整的提示词模板并返回结构化输出

示例：标准化缺陷报告

1. 在聊天中输入 /standardize-bug-report
2. 填写：
   • bugDescription：login button not working on iOS after update
   • additionalContext（可选）：Build 2.3.1, iPhone 15, Premium account
3. AI 会生成完整的标准化缺陷报告（包括重写后的标题）、问题、复现步骤和预期结果

示例：将手动测试用例转换为自动化测试

1. 在聊天中输入 /convert-manual-to-automation
2. 填写：
   • featureNavigation：Settings → Notifications → Push Notifications
   • manualTestCase：（粘贴手动测试用例）
   • existingCode（可选）：（粘贴任何现有的 Page Objects 或 BaseTest，供参考）
3. AI 会生成完整的 TestNG 测试类，其中包含 POM、注解和框架约定

提示词 / 工具输入参考

名称	必填输入	可选输入
convert-manual-to-automation	featureNavigation、manualTestCase	existingCode
refactor-automation-code	code	—
xml-to-pom-locators	pageSourceXml	—
analyze-test-failure	failureLogs	—
standardize-bug-report	bugDescription	additionalContext

本地开发

# Clone the repo
git clone https://github.com/swapnilGirishPawar/Custom-MCP-Server-Mobile-QA.git
cd Custom-MCP-Server-Mobile-QA

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

如需在开发时自动重新加载，请使用 npm run dev（需要 tsx）。

推送前如需在本地测试，请将 MCP 配置指向本地构建：

{
  "mcpServers": {
    "qa-prompts": {
      "command": "node",
      "args": ["/absolute/path/to/Custom-MCP-Server-Mobile-QA/dist/index.js"]
    }
  }
}

技术栈

• 严格模式下的 TypeScript
• @modelcontextprotocol/sdk v1.27+
• 用于输入验证的 Zod v4
• 用于集成 Cursor 的 stdio 传输