Mobile QA Helper

QA プロンプト MCP サーバー

モバイル自動化チーム向けの QA プロンプトテンプレートを提供する MCP（Model Context Protocol）サーバーです。自動化コードの生成、失敗分析、バグの標準化に使える、構造化されたプロンプトとツールを提供します。すべて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 が、POM、アノテーション、フレームワークの規約を使用した、TestNG テストクラス全体を生成します

プロンプト／ツール入力リファレンス

名前	必須入力	任意入力
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 トランスポート