모바일 테스팅 및 모바일 자동화 AI 에이전트 MCP 서버

AI 에이전트와 MCP 도구로 구동되는 모바일 테스팅, 모바일 자동화, 모바일 QA 및 모바일 테스트 자동화 프레임워크입니다.

프로젝트 개요: 모바일 테스팅, 모바일 자동화 및 모바일 QA

이 저장소는 다음을 사용하여 모바일 테스팅 및 모바일 테스트 자동화(웹 검증 포함)를 위한 AI 기반 프레임워크를 제공합니다:

• 플래너 에이전트: 대상 앱이나 사이트를 탐색하고 모바일 QA를 위한 구조화된 Markdown 테스트 계획을 생성합니다.

• 생성기 에이전트: Markdown 테스트 계획을 모바일 자동화 워크플로우를 위한 실행 가능한 Playwright 또는 Mobilewright 테스트로 변환합니다.

• 치유 에이전트: 테스트를 실행하고 실패를 감지하며, 모바일 테스트 자동화 안정성을 향상하기 위해 자동 복구 주기를 시도합니다.

• Android 및 iOS 오케스트레이터: 각 플랫폼 및 모바일 테스팅 수명 주기에 대해 플래너 -> 생성기 -> 치유 에이전트를 엔드투엔드 파이프라인으로 실행합니다.

• MCP 서버: AI 클라이언트 및 자동화 플랫폼을 위해 stdio를 통해 프레임워크를 호출 가능한 MCP 도구로 노출합니다.

이 프레임워크는 모바일 테스트 작성을 가속화하고, 테스트 안정성을 개선하며, AI 지원 모바일 QA 워크플로우를 위한 확장 가능한 기준을 제공하도록 설계되었습니다.

모바일 테스트 자동화를 위한 빠른 설정 (한 번의 명령)

빠른 웹 준비 설정을 위해:

npm install && npx playwright install chromium

그런 다음 기본 웹 테스트를 실행합니다:

npm run test:web

선택적 환경 설정:

cp .env.example .env

Windows PowerShell에서:

Copy-Item .env.example .env

모바일 자동화 및 모바일 QA를 위한 종속성

필수

• Node.js 18+

• npm 9+

• Playwright Chromium 브라우저

핵심 NPM 패키지

• mobilewright

• @playwright/test

• playwright

• @modelcontextprotocol/sdk

• zod

• openai

• dotenv

• fs-extra

• chalk

• axios

• cheerio

플랫폼 필수 조건

웹

• 종속성 및 Chromium 설치 후 추가 설정 없음.

Android

• Android SDK 설치됨

• PATH에서 ADB 사용 가능

• ANDROID_HOME 구성됨

• 최소 하나 이상의 연결된 Android 기기 또는 에뮬레이터

유용한 확인 사항:

npm run doctor
npm run devices

iOS

• 로컬 iOS 자동화를 위한 macOS 호스트

• Xcode + Command Line Tools

• 부팅된 iOS 시뮬레이터(또는 호환되는 클라우드/모바일 기기 제공업체)

모바일 테스팅 프로젝트를 위한 저장소 구조

Mobile-App-Testing-AI-Agent-MCP-Server/
├── agents/
│   ├── planner.js
│   ├── generator.js
│   └── healer.js
├── mcp/
│   └── server.js
├── orchestrators/
│   ├── android-orchestrator.js
│   └── ios-orchestrator.js
├── tests/
│   ├── generated/
│   └── uselessweb/
│       ├── uselessweb.spec.js
│       ├── uselessweb-android.test.js
│       └── uselessweb-ios.test.js
├── plans/
│   └── uselessweb-org--web-test-plan.md
├── reports/
├── mobilewright.config.js
├── playwright.config.js
├── .env.example
└── package.json

모바일 테스팅 및 자동화를 위한 각 영역의 역할

• agents: 모바일 테스트 자동화 파이프라인에서 계획, 생성 및 치유를 위한 AI 에이전트 구현.

• mcp: 플래너, 생성기, 치유 에이전트 및 오케스트레이터 도구를 노출하는 stdio MCP 서버.

• orchestrators: Android 및 iOS 모바일 자동화를 위한 플랫폼별 파이프라인 러너.

• tests: 생성된 테스트 및 모바일 QA를 위한 큐레이팅된 예제를 포함한 실행 가능한 사양.

• plans: 코드 생성을 위한 소스 입력으로 사용되는 Markdown 테스트 계획.

• reports: 모바일 테스팅 및 치유 실행 아티팩트.

모바일 테스팅 및 모바일 QA 사용 가이드

1. 웹 테스트 스위트 실행

npm run test:web

2. Playwright에서 모바일 뷰포트 프로젝트 실행 (모바일 테스팅)

npm run test:mobile-chrome
npm run test:mobile-safari

3. 모바일 자동화를 위한 Android 또는 iOS Mobilewright 테스트 실행

npm run test:android
npm run test:ios

4. 개별 AI 에이전트 사용

플래너

npm run agent:planner
npm run agent:planner:android
npm run agent:planner:ios

직접 CLI 예시:

node agents/planner.js --url=https://uselessweb.org/ --platform=web --out=plans/

생성기

npm run agent:generator
npm run agent:generator:android
npm run agent:generator:ios

직접 CLI 예시:

node agents/generator.js --plan=plans/uselessweb-org--web-test-plan.md --platform=web --out=tests/generated/

치유 에이전트

npm run agent:healer
npm run agent:healer:android
npm run agent:healer:ios

직접 CLI 예시:

node agents/healer.js --spec=tests/uselessweb/uselessweb.spec.js --platform=web --retries=3

5. Android 및 iOS 에이전트로 새 테스트 추가 (모바일 테스트 자동화 흐름)

모바일 QA 프로세스에서 새로운 대상 URL에 대한 테스트를 생성하려는 경우 이 흐름을 사용하십시오.

Android 에이전트 흐름 (계획 -> 생성 -> 실행 -> 치유)

1. Android 테스트 계획 생성:

node agents/planner.js --url=https://uselessweb.org --platform=android --out=plans/

2. 계획에서 Android 테스트 생성:

node agents/generator.js --plan=plans/example-com-android-test-plan.md --platform=android --out=tests/generated/

3. 생성된 Android 테스트 실행:

npx mobilewright test tests/generated/example-com-android-test-plan.test.js

4. 실패한 Android 테스트 자동 치유:

node agents/healer.js --spec=tests/generated/example-com-android-test-plan.test.js --platform=android --retries=3

iOS 에이전트 흐름 (계획 -> 생성 -> 실행 -> 치유)

1. iOS 테스트 계획 생성:

node agents/planner.js --url=https://uselessweb.org --platform=ios --out=plans/

2. 계획에서 iOS 테스트 생성:

node agents/generator.js --plan=plans/example-com-ios-test-plan.md --platform=ios --out=tests/generated/

3. 생성된 iOS 테스트 실행:

npx mobilewright test tests/generated/example-com-ios-test-plan.test.js

4. 실패한 iOS 테스트 자동 치유:

node agents/healer.js --spec=tests/generated/example-com-ios-test-plan.test.js --platform=ios --retries=3

선택 사항: 각 단계를 수동으로 실행하는 대신 오케스트레이터 사용

npm run orchestrate:android -- --url=https://uselessweb.org --retries=3
npm run orchestrate:ios -- --url=https://uselessweb.org --retries=3

6. 모바일 자동화를 위한 오케스트레이션 파이프라인 실행

Android 파이프라인

npm run orchestrate:android

iOS 파이프라인

npm run orchestrate:ios

7. 전체 웹 AI 파이프라인 실행

npm run pipeline:web

이 명령은 웹에 대해 플래너 -> 생성기 -> 치유 에이전트를 실행합니다.

7b. 전체 모바일 QA 파이프라인 실행

각 플랫폼에서 엔드투엔드 모바일 테스트 자동화를 수행하려면:

npm run orchestrate:android
npm run orchestrate:ios

8. MCP 서버 시작

npm run mcp:start

서버는 stdio에서 실행되며 다음을 포함한 도구를 노출합니다:

• health_check

• run_planner

• run_generator

• run_healer

• run_orchestrator

• list_repo_commands

9. 로컬에서 MCP 도구 검사

npm run mcp:inspect

10. MCP 클라이언트 구성 예시

MCP 지원 클라이언트 구성 파일에서 다음을 사용하십시오:

{
   "mcpServers": {
      "mobile-testing-ai-agent": {
         "command": "node",
         "args": ["mcp/server.js"],
         "cwd": "."
      }
   }
}

11. CI/CD 파이프라인 (GitHub Actions)

이 저장소는 이제 .github/workflows/ci-cd.yml에 CI/CD 워크플로우를 포함합니다.

CI 동작:

• main 브랜치로의 푸시 및 main을 대상으로 하는 풀 리퀘스트에서 실행됩니다.

• npm ci로 종속성을 설치합니다.

• Playwright Chromium을 설치합니다.

• npm run test:web으로 웹 스위트를 실행합니다.

• 사용 가능한 경우 Playwright 보고서 아티팩트를 업로드합니다.

CD 동작:

• main 브랜치로의 푸시 시 CI 이후에 실행됩니다.

• DEPLOY_WEBHOOK_URL이 저장소 비밀로 구성된 경우에만 배포를 트리거합니다.

• 비밀이 설정되지 않은 경우 배포를 안전하게 건너뜁니다.

배포를 활성화하려면 다음 저장소 비밀을 추가하십시오:

• DEPLOY_WEBHOOK_URL

모바일 테스팅 및 모바일 자동화에 기여하기

기여를 환영합니다. 아래 워크플로우를 따라주십시오:

1. 저장소를 포크합니다.

2. main에서 기능 브랜치를 생성합니다.

3. 변경 사항을 집중적이고 범위가 명확하게 유지합니다.

4. 새로운 동작에 대한 테스트를 추가하거나 업데이트합니다.

5. PR을 열기 전에 관련 검사를 실행합니다:

   • npm run test:web

   • npm run test:all

   • npm run doctor (모바일 환경용)

6. 다음 내용을 포함하여 풀 리퀘스트를 엽니다:

   • 명확한 문제 진술

   • 구현 요약

   • 검증 증거 (로그, 테스트 출력, 유용한 경우 스크린샷)

기여 가이드라인

• 작고 검토 가능한 풀 리퀘스트를 선호합니다.

• 동일한 PR에서 관련 없는 리팩토링을 피하십시오.

• 스크립트 및 폴더 명명 규칙을 유지하십시오.

• 이 README에 새로운 명령 및 에이전트 동작을 문서화하십시오.

감사의 말

이 프로젝트는 훌륭한 Mobilewright 생태계를 기반으로 구축되었습니다.

• Mobilewright 프레임워크: https://github.com/mobile-next/mobilewright

• Mobilewright 문서: https://mobilewright.dev

Android 및 iOS 전반에서 실용적인 모바일 자동화 워크플로우를 가능하게 해준 Mobilewright 관리자와 기여자분들께 특별히 감사드립니다.

라이선스

ISC

모바일 테스팅 FAQ (SEO)

모바일 테스트 자동화란 무엇입니까?

모바일 테스트 자동화는 도구와 스크립트를 사용하여 Android 및 iOS 전반에서 모바일 앱과 모바일 웹 경험을 자동으로 검증하는 관행입니다.

이 저장소는 모바일 QA에 어떻게 도움이 됩니까?

이 프로젝트는 AI 기반 계획, 테스트 생성, 자가 치유 실행 및 Android와 iOS 오케스트레이션 흐름을 통해 모바일 QA를 지원합니다.

모바일 자동화 팀에 적합합니까?

네. 확장 가능한 모바일 자동화, 반복 가능한 테스트 파이프라인, 릴리스를 위한 더 빠른 피드백 주기가 필요한 팀을 위해 구축되었습니다.

이 프레임워크는 어떤 모바일 테스팅 키워드를 대상으로 합니까?

이 프레임워크는 모바일 테스팅, 모바일 자동화, 모바일 QA 및 모바일 테스트 자동화를 위한 실용적인 워크플로우에 중점을 둡니다.

질문이 있으신가요?

질문이 있으시면:

• 💬 GitHub 토론을 여십시오.

• 🐛 GitHub 이슈를 통해 버그를 보고하십시오.

• 📧 이메일: padmaraj dot nidagundi at gmail.com

응답 시간: 일반적으로 24-48시간

첫 기여자 환영! 👋

오픈 소스가 처음이신가요? 문제없습니다! good-first-issue 또는 help-wanted 태그가 지정된 이슈를 찾아보세요. 성공을 돕기 위해 멘토링과 지침을 제공합니다.

모두를 위해 테스트 자동화를 더 좋게 만들어 주셔서 감사합니다! 🚀