MCP-CLEAN

MCP-CLEAN은 이 컴퓨터에 있는 허용된 프로젝트 폴더를 위한 로컬 제어 센터입니다.

MCP-CLEAN 아키텍처

• server.mjs - MCP 서버 및 도구 구현

• config/allowed-roots.json - 허용된 프로젝트 루트

• backups/ - 프로젝트 아카이브 및 파일 백업

• logs/ - 운영 로그

• logs/actions.log - 작업 감사 기록

• temp/ - 임시 런타임 파일

• exchange/ - 교환 메타데이터 및 프로젝트 노트

• smoke-test.mjs - 로컬 스모크 테스트

Related MCP server: Node Dev MCP Server

사용 가능한 모든 도구

• ping

• list_directory

• read_file

• write_file

• project_status

• backup_project

• health_check

• git_status_all

• git_change_point

• restore_project

• system_status

• project_scan

• safe_change

프로젝트 작업

• 모든 작업은 config/allowed-roots.json의 경로로 제한됩니다.

• system_status 및 git_status_all은 허용된 프로젝트에서만 작동합니다.

• project_scan은 파일을 변경하지 않고 구조를 심층 검사합니다.

• safe_change는 백업과 체크포인트를 통해 프로젝트를 준비합니다.

백업

• 모든 아카이브와 파일 백업은 F:\MCP-CLEAN\backups에만 저장됩니다.

• 아카이브 이름에는 timestamp가 포함됩니다.

• 백업 결과에는 경로, 크기, 프로젝트 정보 및 아카이브 목록이 포함됩니다.

Git 체크포인트

• git_checkpoint는 origin main으로 stage, commit 및 push를 수행합니다.

• 변경 없이 안전하게 확인할 수 있도록 dryRun이 지원됩니다.

롤백

• restore_project는 commit이 지정되지 않은 경우 사용 가능한 체크포인트 commit을 표시합니다.

• 롤백 전에 백업이 생성됩니다.

• 그런 다음 선택된 commit에 대해 git reset --hard가 실행됩니다.

로그

• logs/mcp-clean.log - 운영 기록입니다.

• logs/actions.log - 날짜, 도구, 프로젝트, 작업 및 결과가 포함된 작업 로그입니다.

작업 흐름

1. health_check를 통해 상태를 확인합니다.

2. system_status를 통해 시스템을 확인합니다.

3. project_scan을 통해 프로젝트를 분석합니다.

4. safe_change를 통해 변경을 준비합니다.

5. 필요한 경우 git_checkpoint를 통해 체크포인트를 생성합니다.

6. 필요한 경우 restore_project를 통해 프로젝트를 롤백합니다.