WorkflowMCP

# MCP 통합 테스트 진행 상황 및 다음 단계 가이드 **작성일**: 2025-09-10 **테스트 상태**: 부분 완료 - 4/7단계 성공, 중요한 버그 수정 완료 --- ## 🎯 핵심 발견사항 ### ✅ 완료된 작업 1. **MCP 서버 연결 상태 확인** - 성공 2. **PRD 생성 및 프로젝트 연결 테스트** - 성공 3. **설계-PRD 연결 테스트** - 성공 4. **작업-설계 연결 테스트** - 부분 성공 (작업 생성 성공, 연결 도구 버그 수정 완료) ### 🔧 수정 완료된 중요한 버그 **SQLite 연결 오류 수정**: - **문제**: `src/index.js`에서 `sqlite3.Database`가 `undefined`로 인해 MCP 서버 크래시 - **원인**: ES module dynamic import에서 CommonJS 모듈을 잘못 접근 - **해결**: `sqlite3.Database` → `sqlite3.default.Database`로 모든 인스턴스 수정 - **검증**: 직접 Node.js 테스트로 정상 작동 확인 완료 ### 📋 생성된 테스트 데이터 다음 ID들을 사용하여 남은 테스트를 계속 진행: ```javascript // 서브에이전트가 생성한 데이터 PRD_ID = "5e3be822-d82d-4d43-b205-7695fbae5d61" DESIGN_ID_1 = "0cf398fa-bd0f-4d95-a535-7016f2b0f4ac" // 서브에이전트 생성 DESIGN_ID_2 = "335aa297-b36a-4e31-b0f8-adb95cbf7c28" // 현재 세션 생성 TASK_ID = "c6b932f4-a117-45b4-9331-eda1b3651289" // 현재 세션 생성 ``` --- ## 🚨 즉시 해야 할 작업 (Claude Code 재시작 후) ### 1단계: MCP 서버 연결 확인 ```bash # 백그라운드 서버 시작 (수정된 코드 반영) npm start # MCP 연결 확인 ListMcpResourcesTool() ``` ### 2단계: 수정된 연결 관리 도구 테스트 ```javascript // 작업-설계 연결 (이전에 실패했던 부분) mcp__workflow-mcp__add_task_connection({ task_id: "c6b932f4-a117-45b4-9331-eda1b3651289", entity_type: "design", entity_id: "335aa297-b36a-4e31-b0f8-adb95cbf7c28", connection_type: "related" }) // 작업-PRD 연결 mcp__workflow-mcp__add_task_connection({ task_id: "c6b932f4-a117-45b4-9331-eda1b3651289", entity_type: "prd", entity_id: "5e3be822-d82d-4d43-b205-7695fbae5d61", connection_type: "related" }) // 연결 상태 확인 mcp__workflow-mcp__get_task_connections({ task_id: "c6b932f4-a117-45b4-9331-eda1b3651289" }) ``` ### 3단계: 테스트 케이스 생성 및 전체 연결 테스트 ```javascript mcp__workflow-mcp__create_test_case({ title: "JWT 토큰 생성 API 테스트", description: "JWT 토큰 생성 및 검증 통합 테스트", type: "integration", task_id: "c6b932f4-a117-45b4-9331-eda1b3651289", design_id: "335aa297-b36a-4e31-b0f8-adb95cbf7c28", prd_id: "5e3be822-d82d-4d43-b205-7695fbae5d61", priority: "High", status: "draft" }) ``` ### 4단계: 테스트 케이스 연결 관리 도구 테스트 ```javascript // 테스트 케이스 생성 후 ID를 사용하여 mcp__workflow-mcp__get_test_connections({ test_case_id: "[새 테스트 케이스 ID]" }) mcp__workflow-mcp__add_test_connection({ test_case_id: "[새 테스트 케이스 ID]", entity_type: "task", entity_id: "c6b932f4-a117-45b4-9331-eda1b3651289" }) mcp__workflow-mcp__remove_test_connection({ test_case_id: "[새 테스트 케이스 ID]", entity_type: "design", entity_id: "335aa297-b36a-4e31-b0f8-adb95cbf7c28" }) ``` ### 5단계: 대시보드 검증 브라우저에서 다음 URL들 확인: - http://localhost:3301/prds - PRD 목록 - http://localhost:3301/designs - 설계 목록 및 PRD 연결 - http://localhost:3301/tasks - 작업 목록 및 연결 관계 - http://localhost:3301/tests - 테스트 목록 및 모든 연결 - http://localhost:3301/network - 네트워크 시각화 --- ## 🐛 해결된 기술적 이슈 ### SQLite Driver 문제 해결 **수정 전**: ```javascript const sqlite3 = await import('sqlite3'); const db = await open({ filename: './data/workflow.db', driver: sqlite3.Database // ❌ undefined 에러 }); ``` **수정 후**: ```javascript const sqlite3 = await import('sqlite3'); const db = await open({ filename: './data/workflow.db', driver: sqlite3.default.Database // ✅ 정상 작동 }); ``` **수정된 파일**: `src/index.js` (3곳 모두 수정 완료) ### 검증 완료 ```bash # 직접 테스트로 수정 확인 완료 node -e " const sqlite3 = await import('sqlite3'); const { open } = await import('sqlite'); const db = await open({ filename: './data/workflow.db', driver: sqlite3.default.Database // ✅ 정상 작동 확인 }); " ``` --- ## 📊 현재 데이터베이스 상태 ### 생성된 엔티티 - **PRD**: 33개 (테스트 PRD 포함) - **Design**: 2개 (테스트용) - **Task**: 30개 (테스트 작업 포함) - **Test Case**: 미정 (다음 세션에서 생성) ### 연결 관계 (예상) - PRD → Design: ✅ 성공 (requirement_id 필드 사용) - Design → Task: ⏳ 대기 (연결 도구 테스트 필요) - Task → Test Case: ⏳ 대기 (생성 후 테스트) --- ## ⚠️ 중요 사항 1. **Claude Code 재시작 필수**: 수정된 MCP 서버 코드를 반영하려면 반드시 재시작 2. **백그라운드 프로세스**: `npm start`로 MCP 서버 실행 후 테스트 진행 3. **연결 도구 우선 테스트**: SQLite 드라이버 수정이 제대로 반영되었는지 `add_task_connection` 먼저 확인 4. **대시보드 병렬 확인**: MCP 도구 테스트와 동시에 웹 대시보드에서 실시간 검증 --- ## 🎯 성공 기준 ### 기술적 성공 - [ ] `add_task_connection` 도구 정상 작동 (SQLite 오류 해결) - [ ] 모든 연결 관리 도구 정상 작동 - [ ] 테스트 케이스 생성 및 연결 성공 ### 비즈니스 성공 - [ ] 프로젝트 → PRD → 설계 → 작업 → 테스트 전체 워크플로우 연결 - [ ] 대시보드에서 연결 관계 시각화 확인 - [ ] 네트워크 뷰에서 관계도 정상 표시 --- **다음 세션 시작 시 이 파일을 먼저 읽고 2단계부터 진행하세요.**