Test Genie MCP

AI-powered App Test Automation MCP Server

Multi-platform test automation for iOS, Android, Flutter, React Native, and Web applications.

English

Overview

Test Genie MCP is an AI-powered MCP server for automated app testing. It provides a complete test pipeline from scenario generation to test execution, issue detection, fix suggestions, and automated fixes.

Features

Multi-Platform Support

Platform	Languages	Test Frameworks
iOS	Swift, Objective-C	XCTest, XCUITest, Instruments
Android	Kotlin, Java	Espresso, UI Automator, Android Profiler
Flutter	Dart	flutter_test, integration_test, Golden Tests
React Native	TypeScript, JavaScript	Jest, Detox, RNTL
Web	TypeScript, JavaScript	Playwright, Cypress, Lighthouse

19 MCP Tools

Category	Tools
Analysis	`analyze_app_structure`, `analyze_code_deep`, `analyze_performance`
Scenario	`generate_scenarios`, `create_test_plan`
Execution	`run_scenario_test`, `run_simulation`, `run_stress_test`
Detection	`detect_memory_leaks`, `detect_logic_errors`
Fixing	`suggest_fixes`, `confirm_fix`, `apply_fix`, `rollback_fix`
Automation	`run_full_automation`, `generate_report`, `generate_cicd_config`
Management	`get_pending_fixes`, `get_test_history`

Analysis & Scenario Generation

analyze_app_structure - Analyze codebase structure (screens, components, APIs, state)
analyze_code_deep - AST-based code analysis (complexity, hooks, dependencies)
analyze_performance - Deep performance analysis (rendering, computation, network, bundle)
generate_scenarios - AI-powered test scenario generation
create_test_plan - Create test plans and schedules

Test Execution

run_scenario_test - Execute individual scenario tests
run_simulation - User behavior simulation (random/pattern-based)
run_stress_test - Stress and load testing

Issue Detection

detect_memory_leaks - Memory leak detection (heap analysis, circular references)
detect_logic_errors - Logic error detection (race conditions, state inconsistencies)

Fix Suggestions & Application

suggest_fixes - AI-powered fix suggestions
confirm_fix - User confirmation for fixes
apply_fix - Apply confirmed fixes
rollback_fix - Rollback applied fixes

Automation & CI/CD

run_full_automation - Run complete pipeline automatically
generate_report - Generate detailed reports (Markdown, HTML, JSON)
generate_cicd_config - Generate CI/CD configs (GitHub Actions, Jenkins, GitLab CI)

Management

get_pending_fixes - Get list of pending fix suggestions
get_test_history - Get test execution history

Installation

npm install -g test-genie-mcp

Or install from source:

git clone https://github.com/MUSE-CODE-SPACE/test-genie-mcp.git
cd test-genie-mcp
npm install
npm run build

Usage with Claude Desktop

Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "test-genie": {
      "command": "npx",
      "args": ["test-genie-mcp"]
    }
  }
}

Or use Claude CLI:

claude mcp add test-genie-mcp npx test-genie-mcp

Example Usage

Full Automation

User: "Run automated tests"

Claude will:
1. Analyze your app structure
2. Generate test scenarios
3. Execute tests
4. Detect issues (memory leaks, logic errors)
5. Suggest fixes
6. Wait for your confirmation
7. Apply approved fixes
8. Generate report

Step-by-Step

# Analyze app
analyze_app_structure(projectPath: "/path/to/app")

# Generate scenarios
generate_scenarios(projectPath: "/path/to/app", testTypes: ["e2e", "unit"])

# Detect memory leaks
detect_memory_leaks(projectPath: "/path/to/app")

# Get fix suggestions
suggest_fixes(projectPath: "/path/to/app")

# Confirm and apply fix
confirm_fix(fixId: "xxx", action: "approve")
apply_fix(fixId: "xxx")

Fix Confirmation Workflow

When issues are detected, Test Genie will:

Suggest Fixes: Generate AI-powered fix suggestions with confidence scores
Show Diff: Display exactly what will change
Await Confirmation: Wait for user approval
Apply Fix: Only apply after explicit approval
Backup: Automatically create backups before applying

한국어

개요

Test Genie MCP는 AI 기반 앱 테스트 자동화 MCP 서버입니다. 시나리오 생성부터 테스트 실행, 문제 검출, 수정 제안 및 적용까지 전체 테스트 파이프라인을 자동화합니다.

기능

멀티 플랫폼 지원

플랫폼	언어	테스트 프레임워크
iOS	Swift, Objective-C	XCTest, XCUITest, Instruments
Android	Kotlin, Java	Espresso, UI Automator, Android Profiler
Flutter	Dart	flutter_test, integration_test, Golden Tests
React Native	TypeScript, JavaScript	Jest, Detox, RNTL
Web	TypeScript, JavaScript	Playwright, Cypress, Lighthouse

19개 MCP 도구

카테고리	도구
분석	`analyze_app_structure`, `analyze_code_deep`, `analyze_performance`
시나리오	`generate_scenarios`, `create_test_plan`
실행	`run_scenario_test`, `run_simulation`, `run_stress_test`
탐지	`detect_memory_leaks`, `detect_logic_errors`
수정	`suggest_fixes`, `confirm_fix`, `apply_fix`, `rollback_fix`
자동화	`run_full_automation`, `generate_report`, `generate_cicd_config`
관리	`get_pending_fixes`, `get_test_history`

분석 & 시나리오 생성

analyze_app_structure - 앱 코드베이스 분석 (화면, 컴포넌트, API, 상태관리)
analyze_code_deep - AST 기반 코드 분석 (복잡도, 훅, 의존성)
analyze_performance - 성능 심층 분석 (렌더링, 연산, 네트워크, 번들)
generate_scenarios - AI 기반 테스트 시나리오 자동 생성
create_test_plan - 테스트 계획 수립 및 스케줄링

테스트 실행

run_scenario_test - 개별 시나리오 테스트 실행
run_simulation - 사용자 행동 시뮬레이션 (랜덤/패턴 기반)
run_stress_test - 스트레스/부하 테스트

이슈 검출

detect_memory_leaks - 메모리 릭 감지 (힙 분석, 순환 참조)
detect_logic_errors - 논리적 오류 검출 (레이스 컨디션, 상태 불일치)

수정 제안 & 적용

suggest_fixes - AI 기반 수정 방안 제안
confirm_fix - 수정 사항 사용자 확인
apply_fix - 확인된 수정 사항 적용
rollback_fix - 적용된 수정 롤백

자동화 & CI/CD

run_full_automation - 전체 파이프라인 자동 실행
generate_report - 상세 보고서 생성 (Markdown, HTML, JSON)
generate_cicd_config - CI/CD 설정 자동 생성 (GitHub Actions, Jenkins, GitLab CI)

관리

get_pending_fixes - 대기 중인 수정 제안 목록 조회
get_test_history - 테스트 실행 이력 조회

설치

npm install -g test-genie-mcp

또는 소스에서 설치:

git clone https://github.com/MUSE-CODE-SPACE/test-genie-mcp.git
cd test-genie-mcp
npm install
npm run build

Claude Desktop에서 사용

Claude Desktop 설정 파일 (~/.config/claude/claude_desktop_config.json)에 추가:

{
  "mcpServers": {
    "test-genie": {
      "command": "npx",
      "args": ["test-genie-mcp"]
    }
  }
}

또는 Claude CLI 사용:

claude mcp add test-genie-mcp npx test-genie-mcp

사용 예시

전체 자동화

User: "자동화 테스트해줘"

Claude가 수행:
1. 앱 구조 분석
2. 테스트 시나리오 생성
3. 테스트 실행
4. 문제 검출 (메모리 릭, 로직 오류)
5. 수정 제안
6. 사용자 확인 대기
7. 승인된 수정 적용
8. 보고서 생성

수정 확인 워크플로우

문제가 검출되면 Test Genie가:

수정 제안: 신뢰도 점수와 함께 AI 기반 수정 제안 생성
Diff 표시: 변경될 내용 정확히 표시
확인 대기: 사용자 승인 대기
수정 적용: 명시적 승인 후에만 적용
백업: 적용 전 자동 백업 생성

License

MIT

Author

Yoonkyoung Gong

test-genie

Documentation