MCP Packager

상태 기반 패키징 자동화 MCP (Model Context Protocol) 도구

프로젝트 개요

MCP Packager는 워크스페이스의 변경사항을 지능적으로 감지하고 패키징하는 자동화 도구입니다. 파일 변경사항을 추적하여 효율적인 패키지 배포를 지원합니다.

주요 기능

• 지능적 변경 감지: 파일 수정, 추가, 삭제를 자동으로 감지
• 상태 기반 패키징: 이전 스냅샷과 비교하여 변경된 부분만 패키징
• MCP 프로토콜 지원: Model Context Protocol을 통한 AI 도구 통합
• 자동 문서 생성: 패키징 과정에서 자동으로 문서 생성

프로젝트 구조

mcp_packager/
├── mcp_packager/          # 메인 패키지
│   ├── core/             # 핵심 기능 모듈
│   │   ├── change_detector.py   # 변경사항 감지
│   │   ├── doc_generator.py     # 문서 생성
│   │   ├── file_scanner.py      # 파일 스캔
│   │   ├── orchestrator.py      # 전체 오케스트레이션
│   │   └── packager.py          # 패키징 로직
│   ├── state/            # 상태 관리
│   │   └── snapshot_manager.py  # 스냅샷 관리
│   ├── utils/            # 유틸리티
│   │   └── helpers.py           # 도우미 함수
│   ├── config.py         # 설정 관리
│   ├── main.py          # 메인 진입점
│   └── main_interface.py # MCP 인터페이스
└── docs/                # 문서
    ├── mcp 구축 가이드 문서.md
    └── 상태 기반 패키징 자동화 MCP 도구 PRD.txt

설치 및 실행

요구사항

• Python 3.8 이상
• 필요한 패키지는 requirements.txt에 명시

실행 방법

python -m mcp_packager.main

MCP 도구로 사용

이 도구는 MCP (Model Context Protocol) 서버로 작동하며, AI 도구에서 다음 함수들을 사용할 수 있습니다:

• package: 지정된 폴더를 패키징
• status: 패키징 상태 확인
• info: 도구 정보 확인

개발

코드 스타일

• 포매팅: Black 또는 Ruff 포매터 스타일 준수
• 타입 힌팅: 모든 함수 시그니처에 명시적 타입 힌트 추가
• 문서화: Google 스타일 독스트링 사용
• 언어: 모든 코드 주석 및 독스트링은 한국어로 작성

기여 방법

1. 이 저장소를 포크합니다
2. 새 브랜치를 생성합니다 (git checkout -b feature/새기능)
3. 변경사항을 커밋합니다 (git commit -am '새 기능 추가')
4. 브랜치에 푸시합니다 (git push origin feature/새기능)
5. Pull Request를 생성합니다

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.