test-genie-mcp 2.0.2 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +207 -126
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,51 +1,79 @@
1
1
  # Test Genie MCP
2
2
 
3
- AI-powered App Test Automation MCP Server
3
+ **AI-powered App Test Automation MCP Server**
4
4
 
5
- 앱 테스트 자동화를 위한 MCP 서버입니다. 시나리오 생성부터 테스트 실행, 문제 검출, 수정 제안 및 적용까지 전체 테스트 파이프라인을 자동화합니다.
5
+ > Multi-platform test automation for iOS, Android, Flutter, React Native, and Web applications.
6
6
 
7
- ## Features
7
+ [![npm version](https://img.shields.io/npm/v/test-genie-mcp.svg)](https://www.npmjs.com/package/test-genie-mcp)
8
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
9
 
9
- ### Phase 1: Analysis & Scenario Generation
10
- - **analyze_app_structure**: 앱 코드베이스 분석 (화면, 컴포넌트, API, 상태관리)
11
- - **generate_scenarios**: AI 기반 테스트 시나리오 자동 생성
12
- - **create_test_plan**: 테스트 계획 수립 및 스케줄링
10
+ [English](#english) | [한국어](#korean)
13
11
 
14
- ### Phase 2: Test Execution
15
- - **run_scenario_test**: 개별 시나리오 테스트 실행
16
- - **run_simulation**: 사용자 행동 시뮬레이션 (랜덤/패턴 기반)
17
- - **run_stress_test**: 스트레스/부하 테스트
12
+ ---
18
13
 
19
- ### Phase 3: Issue Detection
20
- - **detect_memory_leaks**: 메모리 릭 감지 (힙 분석, 순환 참조)
21
- - **detect_logic_errors**: 논리적 오류 검출 (레이스 컨디션, 상태 불일치)
14
+ <a name="english"></a>
15
+ ## English
22
16
 
23
- ### Phase 4: Fix Suggestions & Application
24
- - **suggest_fixes**: AI 기반 수정 방안 제안
25
- - **confirm_fix**: 수정 사항 사용자 확인
26
- - **apply_fix**: 확인된 수정 사항 적용
27
- - **rollback_fix**: 적용된 수정 롤백
17
+ ### Overview
28
18
 
29
- ### Phase 5: Full Automation
30
- - **run_full_automation**: 전체 파이프라인 자동 실행
31
- - **generate_report**: 상세 보고서 생성 (Markdown, HTML, JSON)
19
+ 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.
32
20
 
33
- ### Enhanced Analysis (v2.0)
34
- - **analyze_performance**: 성능 심층 분석 (렌더링, 연산, 네트워크, 번들)
35
- - **analyze_code_deep**: AST 기반 코드 분석 (복잡도, 훅, 의존성)
36
- - **generate_cicd_config**: CI/CD 설정 자동 생성 (GitHub Actions, Jenkins, GitLab CI)
21
+ ### Features
37
22
 
38
- ## Supported Platforms
23
+ #### Multi-Platform Support
39
24
 
40
- | Platform | Language | Test Framework |
41
- |----------|----------|----------------|
42
- | iOS | Swift, Objective-C | XCTest, XCUITest |
43
- | Android | Kotlin, Java | Espresso, UI Automator |
44
- | Flutter | Dart | flutter_test |
45
- | React Native | TypeScript, JavaScript | Detox, Jest |
46
- | Web | TypeScript, JavaScript | Playwright, Puppeteer |
25
+ | Platform | Languages | Test Frameworks |
26
+ |----------|-----------|-----------------|
27
+ | iOS | Swift, Objective-C | XCTest, XCUITest, Instruments |
28
+ | Android | Kotlin, Java | Espresso, UI Automator, Android Profiler |
29
+ | Flutter | Dart | flutter_test, integration_test, Golden Tests |
30
+ | React Native | TypeScript, JavaScript | Jest, Detox, RNTL |
31
+ | Web | TypeScript, JavaScript | Playwright, Cypress, Lighthouse |
47
32
 
48
- ## Installation
33
+ #### 19 MCP Tools
34
+
35
+ | Category | Tools |
36
+ |----------|-------|
37
+ | **Analysis** | `analyze_app_structure`, `analyze_code_deep`, `analyze_performance` |
38
+ | **Scenario** | `generate_scenarios`, `create_test_plan` |
39
+ | **Execution** | `run_scenario_test`, `run_simulation`, `run_stress_test` |
40
+ | **Detection** | `detect_memory_leaks`, `detect_logic_errors` |
41
+ | **Fixing** | `suggest_fixes`, `confirm_fix`, `apply_fix`, `rollback_fix` |
42
+ | **Automation** | `run_full_automation`, `generate_report`, `generate_cicd_config` |
43
+ | **Management** | `get_pending_fixes`, `get_test_history` |
44
+
45
+ **Analysis & Scenario Generation**
46
+ - `analyze_app_structure` - Analyze codebase structure (screens, components, APIs, state)
47
+ - `analyze_code_deep` - AST-based code analysis (complexity, hooks, dependencies)
48
+ - `analyze_performance` - Deep performance analysis (rendering, computation, network, bundle)
49
+ - `generate_scenarios` - AI-powered test scenario generation
50
+ - `create_test_plan` - Create test plans and schedules
51
+
52
+ **Test Execution**
53
+ - `run_scenario_test` - Execute individual scenario tests
54
+ - `run_simulation` - User behavior simulation (random/pattern-based)
55
+ - `run_stress_test` - Stress and load testing
56
+
57
+ **Issue Detection**
58
+ - `detect_memory_leaks` - Memory leak detection (heap analysis, circular references)
59
+ - `detect_logic_errors` - Logic error detection (race conditions, state inconsistencies)
60
+
61
+ **Fix Suggestions & Application**
62
+ - `suggest_fixes` - AI-powered fix suggestions
63
+ - `confirm_fix` - User confirmation for fixes
64
+ - `apply_fix` - Apply confirmed fixes
65
+ - `rollback_fix` - Rollback applied fixes
66
+
67
+ **Automation & CI/CD**
68
+ - `run_full_automation` - Run complete pipeline automatically
69
+ - `generate_report` - Generate detailed reports (Markdown, HTML, JSON)
70
+ - `generate_cicd_config` - Generate CI/CD configs (GitHub Actions, Jenkins, GitLab CI)
71
+
72
+ **Management**
73
+ - `get_pending_fixes` - Get list of pending fix suggestions
74
+ - `get_test_history` - Get test execution history
75
+
76
+ ### Installation
49
77
 
50
78
  ```bash
51
79
  npm install -g test-genie-mcp
@@ -60,9 +88,9 @@ npm install
60
88
  npm run build
61
89
  ```
62
90
 
63
- ## Usage with Claude Desktop
91
+ ### Usage with Claude Desktop
64
92
 
65
- Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
93
+ Add to Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
66
94
 
67
95
  ```json
68
96
  {
@@ -75,11 +103,17 @@ Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`
75
103
  }
76
104
  ```
77
105
 
78
- ## Example Usage
106
+ Or use Claude CLI:
79
107
 
80
- ### Full Automation
108
+ ```bash
109
+ claude mcp add test-genie-mcp npx test-genie-mcp
81
110
  ```
82
- User: "자동화 테스트해줘"
111
+
112
+ ### Example Usage
113
+
114
+ #### Full Automation
115
+ ```
116
+ User: "Run automated tests"
83
117
 
84
118
  Claude will:
85
119
  1. Analyze your app structure
@@ -92,9 +126,9 @@ Claude will:
92
126
  8. Generate report
93
127
  ```
94
128
 
95
- ### Step-by-Step
129
+ #### Step-by-Step
96
130
 
97
- ```
131
+ ```bash
98
132
  # Analyze app
99
133
  analyze_app_structure(projectPath: "/path/to/app")
100
134
 
@@ -112,7 +146,7 @@ confirm_fix(fixId: "xxx", action: "approve")
112
146
  apply_fix(fixId: "xxx")
113
147
  ```
114
148
 
115
- ## Fix Confirmation Workflow
149
+ ### Fix Confirmation Workflow
116
150
 
117
151
  When issues are detected, Test Genie will:
118
152
 
@@ -122,93 +156,140 @@ When issues are detected, Test Genie will:
122
156
  4. **Apply Fix**: Only apply after explicit approval
123
157
  5. **Backup**: Automatically create backups before applying
124
158
 
125
- Example confirmation prompt:
159
+ ---
160
+
161
+ <a name="korean"></a>
162
+ ## 한국어
163
+
164
+ ### 개요
126
165
 
166
+ Test Genie MCP는 AI 기반 앱 테스트 자동화 MCP 서버입니다. 시나리오 생성부터 테스트 실행, 문제 검출, 수정 제안 및 적용까지 전체 테스트 파이프라인을 자동화합니다.
167
+
168
+ ### 기능
169
+
170
+ #### 멀티 플랫폼 지원
171
+
172
+ | 플랫폼 | 언어 | 테스트 프레임워크 |
173
+ |--------|------|-------------------|
174
+ | iOS | Swift, Objective-C | XCTest, XCUITest, Instruments |
175
+ | Android | Kotlin, Java | Espresso, UI Automator, Android Profiler |
176
+ | Flutter | Dart | flutter_test, integration_test, Golden Tests |
177
+ | React Native | TypeScript, JavaScript | Jest, Detox, RNTL |
178
+ | Web | TypeScript, JavaScript | Playwright, Cypress, Lighthouse |
179
+
180
+ #### 19개 MCP 도구
181
+
182
+ | 카테고리 | 도구 |
183
+ |----------|------|
184
+ | **분석** | `analyze_app_structure`, `analyze_code_deep`, `analyze_performance` |
185
+ | **시나리오** | `generate_scenarios`, `create_test_plan` |
186
+ | **실행** | `run_scenario_test`, `run_simulation`, `run_stress_test` |
187
+ | **탐지** | `detect_memory_leaks`, `detect_logic_errors` |
188
+ | **수정** | `suggest_fixes`, `confirm_fix`, `apply_fix`, `rollback_fix` |
189
+ | **자동화** | `run_full_automation`, `generate_report`, `generate_cicd_config` |
190
+ | **관리** | `get_pending_fixes`, `get_test_history` |
191
+
192
+ **분석 & 시나리오 생성**
193
+ - `analyze_app_structure` - 앱 코드베이스 분석 (화면, 컴포넌트, API, 상태관리)
194
+ - `analyze_code_deep` - AST 기반 코드 분석 (복잡도, 훅, 의존성)
195
+ - `analyze_performance` - 성능 심층 분석 (렌더링, 연산, 네트워크, 번들)
196
+ - `generate_scenarios` - AI 기반 테스트 시나리오 자동 생성
197
+ - `create_test_plan` - 테스트 계획 수립 및 스케줄링
198
+
199
+ **테스트 실행**
200
+ - `run_scenario_test` - 개별 시나리오 테스트 실행
201
+ - `run_simulation` - 사용자 행동 시뮬레이션 (랜덤/패턴 기반)
202
+ - `run_stress_test` - 스트레스/부하 테스트
203
+
204
+ **이슈 검출**
205
+ - `detect_memory_leaks` - 메모리 릭 감지 (힙 분석, 순환 참조)
206
+ - `detect_logic_errors` - 논리적 오류 검출 (레이스 컨디션, 상태 불일치)
207
+
208
+ **수정 제안 & 적용**
209
+ - `suggest_fixes` - AI 기반 수정 방안 제안
210
+ - `confirm_fix` - 수정 사항 사용자 확인
211
+ - `apply_fix` - 확인된 수정 사항 적용
212
+ - `rollback_fix` - 적용된 수정 롤백
213
+
214
+ **자동화 & CI/CD**
215
+ - `run_full_automation` - 전체 파이프라인 자동 실행
216
+ - `generate_report` - 상세 보고서 생성 (Markdown, HTML, JSON)
217
+ - `generate_cicd_config` - CI/CD 설정 자동 생성 (GitHub Actions, Jenkins, GitLab CI)
218
+
219
+ **관리**
220
+ - `get_pending_fixes` - 대기 중인 수정 제안 목록 조회
221
+ - `get_test_history` - 테스트 실행 이력 조회
222
+
223
+ ### 설치
224
+
225
+ ```bash
226
+ npm install -g test-genie-mcp
127
227
  ```
128
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
129
- 🔧 Fix Suggestion #abc123
130
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
131
-
132
- 📁 File: src/screens/HomeScreen.tsx:45
133
- 📝 Title: Fix: useEffect missing cleanup
134
- 🎯 Confidence: 90%
135
-
136
- 📄 Current Code:
137
- ┌──────────────────────────────────────────
138
- │ useEffect(() => {
139
- │ const subscription = api.subscribe();
140
- │ }, []);
141
- └──────────────────────────────────────────
142
-
143
- ✨ Suggested Fix:
144
- ┌──────────────────────────────────────────
145
- │ useEffect(() => {
146
- │ const subscription = api.subscribe();
147
- │ return () => subscription.unsubscribe();
148
- │ }, []);
149
- └──────────────────────────────────────────
150
-
151
- Actions: [✅ Approve] [❌ Reject] [✏️ Modify]
152
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
228
+
229
+ 또는 소스에서 설치:
230
+
231
+ ```bash
232
+ git clone https://github.com/MUSE-CODE-SPACE/test-genie-mcp.git
233
+ cd test-genie-mcp
234
+ npm install
235
+ npm run build
153
236
  ```
154
237
 
155
- ## Tools Reference
156
-
157
- | Tool | Description |
158
- |------|-------------|
159
- | `analyze_app_structure` | Analyze codebase structure |
160
- | `generate_scenarios` | Generate test scenarios |
161
- | `create_test_plan` | Create test plan |
162
- | `run_scenario_test` | Run single scenario |
163
- | `run_simulation` | Run user simulation |
164
- | `run_stress_test` | Run stress test |
165
- | `detect_memory_leaks` | Detect memory leaks |
166
- | `detect_logic_errors` | Detect logic errors |
167
- | `suggest_fixes` | Generate fix suggestions |
168
- | `confirm_fix` | Confirm/reject fix |
169
- | `apply_fix` | Apply confirmed fix |
170
- | `rollback_fix` | Rollback applied fix |
171
- | `run_full_automation` | Run full automation pipeline |
172
- | `generate_report` | Generate test report |
173
- | `get_pending_fixes` | Get pending confirmations |
174
- | `get_test_history` | Get test history |
175
- | `analyze_performance` | Deep performance analysis |
176
- | `analyze_code_deep` | AST-based code analysis |
177
- | `generate_cicd_config` | Generate CI/CD configuration |
178
-
179
- ## Platform-Specific Features
180
-
181
- ### iOS
182
- - XCTest, XCUITest integration
183
- - Instruments profiling (Time Profiler, Allocations, Leaks)
184
- - Simulator management
185
- - Screenshot & video recording
186
-
187
- ### Android
188
- - Gradle test integration
189
- - Espresso, UI Automator support
190
- - Android Profiler (CPU, Memory, Network)
191
- - LeakCanary integration
192
- - ADB device management
193
-
194
- ### Flutter
195
- - flutter_test, integration_test
196
- - Golden tests (snapshot testing)
197
- - Performance profiling
198
- - Memory analysis
199
-
200
- ### React Native
201
- - Jest, React Native Testing Library
202
- - Detox E2E testing
203
- - Performance monitoring
204
- - Memory leak detection
205
-
206
- ### Web
207
- - Playwright, Cypress support
208
- - Lighthouse performance audits
209
- - Accessibility testing (axe-core)
210
- - Visual regression testing
211
- - Load testing (K6 integration)
238
+ ### Claude Desktop에서 사용
239
+
240
+ Claude Desktop 설정 파일 (`~/.config/claude/claude_desktop_config.json`)에 추가:
241
+
242
+ ```json
243
+ {
244
+ "mcpServers": {
245
+ "test-genie": {
246
+ "command": "npx",
247
+ "args": ["test-genie-mcp"]
248
+ }
249
+ }
250
+ }
251
+ ```
252
+
253
+ 또는 Claude CLI 사용:
254
+
255
+ ```bash
256
+ claude mcp add test-genie-mcp npx test-genie-mcp
257
+ ```
258
+
259
+ ### 사용 예시
260
+
261
+ #### 전체 자동화
262
+ ```
263
+ User: "자동화 테스트해줘"
264
+
265
+ Claude가 수행:
266
+ 1. 앱 구조 분석
267
+ 2. 테스트 시나리오 생성
268
+ 3. 테스트 실행
269
+ 4. 문제 검출 (메모리 릭, 로직 오류)
270
+ 5. 수정 제안
271
+ 6. 사용자 확인 대기
272
+ 7. 승인된 수정 적용
273
+ 8. 보고서 생성
274
+ ```
275
+
276
+ ### 수정 확인 워크플로우
277
+
278
+ 문제가 검출되면 Test Genie가:
279
+
280
+ 1. **수정 제안**: 신뢰도 점수와 함께 AI 기반 수정 제안 생성
281
+ 2. **Diff 표시**: 변경될 내용 정확히 표시
282
+ 3. **확인 대기**: 사용자 승인 대기
283
+ 4. **수정 적용**: 명시적 승인 후에만 적용
284
+ 5. **백업**: 적용 전 자동 백업 생성
285
+
286
+ ---
287
+
288
+ ## Links
289
+
290
+ - [npm Package](https://www.npmjs.com/package/test-genie-mcp)
291
+ - [GitHub Repository](https://github.com/MUSE-CODE-SPACE/test-genie-mcp)
292
+ - [MCP Registry](https://registry.modelcontextprotocol.io)
212
293
 
213
294
  ## License
214
295
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "test-genie-mcp",
3
- "version": "2.0.2",
3
+ "version": "2.0.3",
4
4
  "mcpName": "io.github.MUSE-CODE-SPACE/test-genie",
5
5
  "description": "AI-powered app test automation MCP server - scenario generation, execution, detection, and auto-fixing",
6
6
  "main": "dist/index.js",