QAFusionX

순차적 MCP QA 에이전트. 이 서버가 Cursor에서 연결되면 Ask 모드를 잠그고, 두 가지 필수 질문을 한 다음, 건너뛸 수 없는 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차 계획 / 할 일 고정.

6. 2차 크롤링 — 동일한 디렉터리 구조로, 1차에서 놓친 것을 찾기.

7. 사용자 스토리 생성 — 질문 2가 시스템에서 생성이었을 때만. 2차 이후, 캡처된 모든 흐름에서 GeneratedUser stories/를 생성합니다. 이후 테스트는 해당 세트만 사용합니다. Zip/Jira 실행은 이 단계를 N/A로 표시합니다.

8. 시스템 맵 완성 — 길고 철저한 마크다운 (짧은 파일은 거부됨).

9. 인간 테스트 케이스를 Jira 기능 형식으로 testCase Human/에 작성.

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 기능 케이스와 일치)에 대해 모든 단계를 실행합니다.

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

이것은 자동으로 연결 및 부트스트랩 (없으면 clone + 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, 또는 생성). 이 두 번째 질문은 필수입니다.

두 답변이 모두 저장될 때까지, 이후 모든 도구는 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는 중지하고 사용자 자신의 컴퓨터에서 실행하라고 알려줍니다. 헤드리스로 계속하지 않습니다.

신할라어 — මෙය කොහොමද පාවිච්චි කරන්නේ

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 කරලා තියෙනවා.