QAFusionX

シーケンシャルMCP QAエージェント。このサーバーをCursorで接続するとAskモードがロックされ、2つの必須質問を行った後、スキップできない15ステップのワークフローを実行します。ステップNを完了するとstep-by-step/にチェックマークが書き込まれ、そのチェックマークが唯一のステップN+1のロック解除方法です。

Control Consoleは同じエンジンのライブGUIです。番号付きパイプライン、Askモードバナー、アーティファクトブラウザ、そして視聴できるテスト実行コンソールを備えています。

ロック済み — すべてのユーザーのデバイスでブラウザを表示。 ワークフローはパイプラインですが、クロールとGUIテストはその中でサイレントジョブとして実行されることはありません。ユーザーが自分のマシンでQAFusionXを実行すると、そのデバイスで別のブラウザウィンドウが開き、すべての画面、ポップアップ、クリックが表示されます。ヘッドレスは拒否されます。サイレントモードはありません。

機能

1. 質問 — プロジェクトとターゲット（Askモード）— 製品名、テスト対象、ライブURL、スクリーンショット。

2. 質問 — ユーザーストーリー（Askモード、必須）— zip / ファイル、Jiraリンク、またはシステムからの生成。

3. User stories/とGeneral/01-target.mdを永続化。

4. ラウンド1クロール — すべての画面とポップアップ：キャプチャ → 推論 → 参照MD → 実行計画 → 次のクリック。

5. ラウンド1の計画 / TODOを凍結。

6. ラウンド2クロール — 同じディレクトリ構造で、ラウンド1が見逃したものを探す。

7. ユーザーストーリーの生成 — 質問2がシステムからの生成だった場合のみ。ラウンド2の後、キャプチャしたすべてのフローからGeneratedUser stories/を作成。以降のテストはそのセットのみを使用。zip / Jira実行ではこのステップはN/Aとマーク。

8. システムマップの完成 — 長く網羅的なマークダウン（短いファイルは拒否）。

9. 人間用テストケースをtestCase Human/の下にJira機能形式で作成。

10. それらのケースをJiraにアップロード（またはオフラインペイロードを書き込み）。

11. testc2ai/に1:1でYAMLに変換。

12. AutomatedScripts/にGUIおよびAPIのPlaywrightスクリプトを生成。

13. 表示されるヘッド付きブラウザでスイートを実行（すべてのクリックを視聴）し、結果もGUIにストリーミング。

14. 失敗をreports/QAFusionX-Issues.xlsx + .csvに証拠付きでエクスポート。

15. Jiraのバグチケットを提出：件名、前提条件、手順、期待結果、実際の結果、証拠。

Related MCP server: mcp-playwright-test

ローカルで実行

npm install
npx playwright install chromium
cd console && npm install && cd ..
cp .env.example .env   # optional Jira credentials
npm run dev

• Control Console: http://127.0.0.1:43181

• Engine API: http://127.0.0.1:43180

• テスト対象のサンプルアプリ: http://127.0.0.1:43181/sample/login
  デモログイン: qa.analyst / FusionX@2026

コンソールでRun guided demoをクリックすると、バンドルされたIntermediary Managementサンプル（Jira機能ケースに一致するEmergency Detailsフィールド）に対してすべてのステップを実行します。

MCPのみ:

npx tsx src/index.ts

QAFusionXをCursorに接続（すべてのプロジェクト、すべてのチャット）

Windows — フルTBB + メッシュインストール（推奨）:

git clone https://github.com/thejanaloit/QAFusionX.git $env:USERPROFILE\QAFusionX
cd $env:USERPROFILE\QAFusionX
npm run install:mesh
# or: powershell -ExecutionPolicy Bypass -File .\scripts\install-full-mesh.ps1

これにより自動的にリンクおよびブートストラップ（欠落している場合はクローン + npm install）が行われます:

設定はconfig/tbb-mesh.jsonにあります。インストール前に環境変数（THEJA_BACKBONE_ROOTなど）でルートを上書きします。

macOS / Linux:

git clone https://github.com/thejanaloit/QAFusionX.git ~/QAFusionX
cd ~/QAFusionX
npm install --omit=dev
python3 scripts/link-tbb-mesh.py
bash scripts/install-global-cursor.sh

これによりユーザーレベルの設定（~/.cursor/mcp.json）とユーザールール（~/.cursor/rules/qafusionx.mdc、qafusionx-visible-browser.mdc）が書き込まれます。CursorはそれをすべてのワークスペースとすべてのAgent/Askチャットにマージします。次に:

1. コマンドパレット → Developer: Reload Window

2. 設定 → Tools & MCP → QAFusionXをオンにする（緑）

このリポジトリには.cursor/mcp.jsonもあるため、QAFusionXフォルダを開くだけで十分です。インストーラーがグローバルにするものです。

初回使用時にエージェントは必須で:

1. Askモードに切り替える。

2. プロジェクトとテスト対象（URL + スクリーンショット）を尋ねる。

3. ユーザーストーリー（zip、Jira、または生成）を尋ねる。この2番目の質問は必須です。

両方の回答が保存されるまで、以降のすべてのツールはBLOCKEDを返します。

GitHubに公開

このプロジェクトを構築したクラウドエージェントにはGitHubログインがないため、ここからgithub.com/<you>/QAFusionXを作成できません。ソースはすでにCursor Originリモートにあります。お使いのマシンでgh auth loginの後:

bash scripts/publish-github.sh QAFusionX public

これによりGitHubリポジトリが作成され、githubリモートが追加され、mainがプッシュされます。

ユーザーストーリーのソース

アーティファクトレイアウト

artifacts/
  step-by-step/                 ticks — the only unlock
  User stories/                 zip / Jira stories
  GeneratedUser stories/        method 3 only, after Round 2
  General/                      01-target.md, human-qa-research.md
  Screens/
    round one/screenshots|references|plan/
    round two/screenshots|references|plan/
    complete-system-map.md
  testCase Human/               Jira-shaped markdown + json
  testc2ai/                     YAML for the AI runner
  AutomatedScripts/gui|api
  reports/                      suite results, XLSX/CSV, proof
  jira/                         upload log, payloads, created keys
  bugs/                         bug tickets with proof

人間用テストケースの形式

タイトルはJira機能パターンに従います:

[Sales & Marketing Module] [Intermediary Management][Add new/Manage][FP] - Validate that the Emergency Details section displays all required fields.

必須セクション: Affects versions、Labels、Test Case Type、Priority、Parent、Linked work items、Preconditions、Test Steps、Test Comments、Expected Result、Actual Result。

Jira

JIRA_BASE_URL、JIRA_EMAIL、JIRA_API_TOKEN、JIRA_PROJECT_KEYを設定します。これらがない場合でも、QAFusionXはjira/payloads/*.jsonを書き込むことでステップを完了します — ノードをスキップすることはありません。

表示ブラウザ（ロック済み）

このルールはエンジン、MCPプロトコル、Cursorルールでロックされています。オフにすることはできません。

パイプラインはステップバイステップで実行されます。これはラウンド1、ラウンド2、またはGUIテストがバックグラウンドで実行されることを意味しません。

QAFusionXがユーザーのデバイスで実行されるとき:

1. 別の実際のブラウザウィンドウがそのデバイスで開きます。

2. クロールとGUIテストはそのウィンドウで行われます。

3. ユーザーはすべてのナビゲーションとクリックを視聴します。

QAFUSIONX_HEADED=0は拒否されます。マシンにディスプレイがない場合、QAFusionXは停止し、ユーザー自身のコンピュータで実行するように指示します。ヘッドレスで続行することはありません。

Sinhala — මෙය කොහොමද පාවිච්චි කරන්නේ

Cursor එකේ QAFusionX MCP එක connect කළාම Ask mode එකට යන්න. මුලින්ම project එක සහ test කරන්න ඕන දේ, URL එක, screenshot එක අහනවා. ඊට පස්සේ අනිවාර්යයෙන් user stories අහනවා — zip, Jira link, හෝ system එකෙන් generate. මේ දෙකම උත්තර දුන්නට පස්සේ විතරක් crawl / test generation පටන් ගන්න පුළුවන්. කිසිම step එකක් skip කරලා ඊළඟ එකට යන්න බෑ; step-by-step/ තියෙන tick එක තමයි ඊළඟ unlock එක.

මේක කිසිම සෙත්ම pipeline එකක් ඇතුළේ කරනවා වගේ කරන්න එපා. හැම user කෙනෙක්ගේමම device එකේ වෙනම browser එකක් open වෙලා ඒකෙන් පේන්න ඕන. Headless lock කරලා තියෙනවා.