Test Genie MCP

🚀 Test Genie MCP

AI-powered App Test Automation MCP Server, enabling multi-platform test automation for iOS, Android, Flutter, React Native, and Web applications.

English | 한국어

🚀 Quick Start

Test Genie MCP is an AI-powered MCP server designed for automated app testing. It offers a comprehensive test pipeline that covers everything from scenario generation to test execution, issue detection, fix suggestions, and automated fixes.

✨ Features

Multi-Platform Support

19 MCP Tools

Analysis & Scenario Generation

• analyze_app_structure: Analyze the codebase structure, including screens, components, APIs, and state.
• analyze_code_deep: Conduct AST-based code analysis, covering complexity, hooks, and dependencies.
• analyze_performance: Perform in-depth performance analysis, such as rendering, computation, network, and bundle analysis.
• generate_scenarios: Generate test scenarios powered by AI.
• create_test_plan: Create test plans and schedules.

Test Execution

• run_scenario_test: Execute individual scenario tests.
• run_simulation: Simulate user behavior, either randomly or based on patterns.
• run_stress_test: Conduct stress and load testing.

Issue Detection

• detect_memory_leaks: Detect memory leaks through heap analysis and circular reference checks.
• detect_logic_errors: Detect logic errors, such as race conditions and state inconsistencies.

Fix Suggestions & Application

• suggest_fixes: Provide AI-powered fix suggestions.
• confirm_fix: Wait for user confirmation of fixes.
• apply_fix: Apply the confirmed fixes.
• rollback_fix: Roll back the applied fixes.

Automation & CI/CD

• run_full_automation: Automatically run the entire pipeline.
• generate_report: Generate detailed reports in Markdown, HTML, or JSON formats.
• generate_cicd_config: Generate CI/CD configurations for GitHub Actions, Jenkins, or GitLab CI.

Management

• get_pending_fixes: Get the list of pending fix suggestions.
• get_test_history: Get the test execution history.

📦 Installation

You can install Test Genie MCP via npm:

npm install -g test-genie-mcp

Or install it from the source:

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

💻 Usage Examples

Usage with Claude Desktop

Add the following configuration to Claude Desktop (~/.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:

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

📚 Documentation

한국어

개요

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

기능

멀티 플랫폼 지원

19개 MCP 도구

분석 & 시나리오 생성

• 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가:

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

📄 License

This project is licensed under the MIT license.

👨‍💻 Author

Yoonkyoung Gong

🔗 Links

• npm Package
• GitHub Repository
• MCP Registry