MCP 프로젝트 관리자 (터미널 + 웹 + 데스크톱)

이 프로젝트는 하나의 백엔드에서 세 가지 인터페이스를 지원합니다:

• 터미널 제품군

• REST API + React UI

• MCP stdio 서버

• 선택적 Python 데스크톱 런처 (로컬 앱으로 브라우저 실행)

빠른 시작

1. 인프라 시작: docker compose up -d

2. 스키마 적용: psql postgresql://postgres:postgres@localhost:5432/mcp_pm -f backend/sql/schema.sql

3. http://localhost:4000/용 프론트엔드 빌드: npm run build

4. API 서버 시작: npm run start

프론트엔드 빌드가 누락된 경우, /는 다음 단계를 안내하는 명확한 메시지를 반환합니다.

개별 실행 모드

• 터미널 제품군: npm run terminal

• MCP stdio 서버: npm run mcp

• 데스크톱 런처 (연결 모드): npm run desktop

• 데스크톱 런처 (백엔드 자동 시작): npm run desktop:start

백엔드 워크스페이스 대응:

• npm --workspace backend run terminal

• npm --workspace backend run mcp

• npm --workspace backend run desktop

• npm --workspace backend run desktop:start

API 추가 사항

• GET /api/projects/:id/plans (필터 + 페이지네이션)

• GET /api/projects/:id/plans/compare?againstVersion=N

• POST /api/plans/:planId/promote-baseline

• POST /api/analysis/summarize-codebase (폴더 전체 요약, 파일별 설명, Mermaid 파이프라인)

• 피드백 작업에 needs_review 포함

• 구조 생성 옵션: profile, dryRun, overwriteStrategy

파일 시스템 안전성

파일 시스템 엔드포인트는 FS_BASE_PATH(기본값: 백엔드 작업 디렉토리)로 제한됩니다.