WorkflowMCP

# 작업 계획 관리 MCP 개발 계획 **문서 정보** - 문서 타입: PLAN (개발계획) - 프로젝트: WorkPlanMCP (작업 계획 관리 MCP) - 작성일: 2025-01-05 - 상태: 초안 --- ## 프로젝트 개요 ### 목표 작업 계획의 전체 라이프사이클을 관리하는 MCP 서버 개발 - 계획 생성 → 실행 추적 → 결과 평가 → 인사이트 도출 ### 핵심 요구사항 1. 정형화된 작업 계획 템플릿 제공 2. 계획 실행 상태 자동 추적 3. 성공/실패 결과 기록 및 분석 4. 이전 계획 검색 및 패턴 분석 --- ## 기능 명세 ### 1. 계획 생성 단계 **기능:** - 정형화된 템플릿 기반 계획 작성 - 자동 ID 생성 (타임스탬프 기반) - JSON/마크다운 형태 저장 **템플릿 구조:** ```json { "id": "PLAN_20250105_001", "title": "계획 제목", "created": "2025-01-05T10:00:00Z", "status": "created", "sections": { "objective": "목표 및 달성하고자 하는 결과", "requirements": "요구사항 및 제약조건", "resources": "필요한 리소스 (시간, 도구, 정보)", "steps": "실행 단계별 상세 내용", "risks": "예상되는 위험요소 및 대응책", "success_criteria": "성공 판단 기준" } } ``` ### 2. 실행 추적 단계 **기능:** - 계획 상태 업데이트 (created → in_progress → completed/failed) - 실행 과정 로그 기록 - 단계별 진행률 추적 **상태 관리:** - `created`: 계획 생성됨 - `in_progress`: 실행 중 - `completed`: 성공적으로 완료 - `failed`: 실행 실패 - `paused`: 일시 중단 - `cancelled`: 취소됨 ### 3. 결과 평가 단계 **기능:** - 성공/실패 여부 기록 - 실패 원인 분석 - 개선사항 및 교훈 도출 - 다음 계획 수립을위한 인사이트 제공 **결과 구조:** ```json { "plan_id": "PLAN_20250105_001", "result": { "status": "completed|failed", "completion_date": "2025-01-05T15:00:00Z", "success_rate": 85, "lessons_learned": ["교훈1", "교훈2"], "improvements": ["개선사항1", "개선사항2"], "next_actions": ["후속 작업1", "후속 작업2"] } } ``` ### 4. 검색 및 분석 기능 **기능:** - 키워드 기반 계획 검색 - 성공률 통계 분석 - 반복되는 실패 패턴 식별 - 성공 요인 분석 --- ## 기술 구조 ### MCP 서버 아키텍처 ``` WorkPlanMCP/ ├── src/ │ ├── server.js # MCP 서버 메인 │ ├── handlers/ │ │ ├── plan.js # 계획 관리 핸들러 │ │ ├── tracking.js # 진행 추적 핸들러 │ │ └── analysis.js # 분석 핸들러 │ ├── storage/ │ │ ├── database.js # 데이터 저장 관리 │ │ └── templates.js # 템플릿 관리 │ └── utils/ │ ├── validation.js # 데이터 검증 │ └── formatter.js # 출력 형식화 ├── data/ │ ├── plans/ # 계획 저장소 │ ├── results/ # 결과 저장소 │ └── templates/ # 템플릿 파일들 └── package.json ``` ### MCP 도구 목록 1. `create_plan` - 새 계획 생성 2. `update_plan_status` - 계획 상태 업데이트 3. `add_execution_log` - 실행 로그 추가 4. `complete_plan` - 계획 완료 처리 5. `search_plans` - 계획 검색 6. `get_plan_details` - 계획 상세 조회 7. `analyze_success_patterns` - 성공 패턴 분석 --- ## 개발 단계 ### Phase 1: 기본 구조 (1-2일) - [ ] MCP 서버 기본 골격 구축 - [ ] 계획 생성/조회 기능 구현 - [ ] 기본 템플릿 정의 ### Phase 2: 핵심 기능 (2-3일) - [ ] 상태 추적 시스템 구현 - [ ] 실행 로그 관리 기능 - [ ] 결과 평가 시스템 ### Phase 3: 고급 기능 (2-3일) - [ ] 검색 및 필터링 기능 - [ ] 통계 분석 기능 - [ ] 패턴 인식 알고리즘 ### Phase 4: 테스트 및 최적화 (1-2일) - [ ] 단위 테스트 작성 - [ ] 성능 최적화 - [ ] 문서화 완성 --- ## 성공 기준 1. 정형화된 계획 작성이 5분 내 완료 2. 실행 상태가 실시간으로 추적됨 3. 이전 계획 검색이 1초 내 완료 4. 성공/실패 패턴이 명확하게 분석됨 5. Claude Code와의 원활한 통합 --- ## 위험 요소 및 대응책 - **위험**: MCP 프로토콜 복잡성 - **대응**: 기존 MCP 예제 참조 및 단계별 구현 - **위험**: 데이터 일관성 문제 - **대응**: JSON Schema 검증 및 백업 시스템 - **위험**: 성능 이슈 (대량 데이터) - **대응**: 인덱싱 및 페이지네이션 구현 --- **다음 단계**: MCP 아키텍처 상세 설계 및 프로토타입 구현 시작