Git 포렌식 MCP

심층적인 Git 저장소 조사 및 분석을 위한 특수 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 포렌식 도구는 저장소 이력, 브랜치 관계 및 개발 패턴에 대한 상세한 통찰력을 제공하며, 일반적인 GitHub 또는 Git 작업이 아닌 Git 저장소 분석에만 집중합니다.

특징

서버는 4가지 주요 분석 도구를 제공합니다.

1. 지점 개요 ( get_branch_overview )
   • 지점 상태 및 관계에 대한 높은 수준의 개요를 제공합니다.
   • 마지막 커밋, 커밋 수 및 병합 기반을 분석합니다.
   • 지점 활동에 대한 통계 요약을 생성합니다.
2. 기간 분석 ( analyze_time_period )
   • 특정 기간 동안의 자세한 개발 활동을 분석합니다.
   • 커밋을 분류합니다(기능, 수정, 리팩토링, 문서, 기타)
   • 커밋 패턴을 사용하여 활동 요약을 제공합니다.
3. 파일 변경 분석 ( analyze_file_changes )
   • 여러 지점에서 특정 파일의 변경 사항을 추적합니다.
   • 잠재적인 갈등 영역을 식별합니다
   • 파일 수정에 대한 위험 평가를 제공합니다.
   • 위험 수준에 따라 권장 검토 순서를 생성합니다.
4. 병합 권장 사항 ( get_merge_recommendations )
   • 최적의 병합 전략을 결정합니다
   • 갈등 위험을 평가합니다
   • 코드 핫스팟을 식별합니다
   • 단계별 병합 지침을 제공합니다.

입력 매개변수

각 도구에는 특정 매개변수가 필요합니다.

• repoPath : git 저장소 경로
• branches : 분석할 브랜치 이름 배열
• outputPath : 분석 결과가 기록될 경로
• 추가 도구별 매개변수:
  • timeRange : 기간 분석을 위한 시작 및 종료 날짜
  • files : 파일 변경 분석을 위한 파일 경로 배열

출력 형식

모든 도구는 다음을 포함하는 JSON 파일을 출력합니다.

• 상세 분석 결과
• 요약 통계
• 위험 평가(해당되는 경우)
• 분석에 따른 권장 사항

기술적 세부 사항

• TypeScript로 구축됨
• 서버 구현을 위해 MCP SDK를 사용합니다.
• 자식 프로세스를 통해 git 명령을 실행합니다.
• 오류 처리 및 검증을 제공합니다
• stdio 전송에서 실행됩니다

종속성

• @modelcontextprotocol/sdk
• 노드.js
• Git(설치 및 접근 가능해야 함)

용법

서버는 MCP 서비스로 실행되며 모든 MCP 호환 클라이언트와 통합될 수 있습니다. 모든 분석 결과는 JSON 형식으로 지정된 출력 파일에 기록됩니다.

기여 및 라이센스

이 프로젝트는 Apache 라이선스 버전 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE.txt 파일을 참조하세요.

협업 환영

포크와 기여를 환영합니다.

모든 기여는 Apache 라이선스 2.0에 따라 이루어집니다. 이 라이선스는 다음과 같은 권한을 부여합니다.

• 코드를 상업적으로 사용하세요
• 코드 수정 및 배포
• 파생 작품 만들기
• 다른 프로젝트에 포함

저작권 2025. Apache 라이선스 버전 2.0에 따라 라이선스가 부여되었습니다. 라이선스를 준수하지 않는 한 이 프로젝트를 사용할 수 없습니다. 라이선스 사본은 http://www.apache.org/licenses/LICENSE-2.0 에서 확인하실 수 있습니다.