mcp-git-tools

AI 에이전트를 위한 Git 저장소 분석 도구로, MCP(Model Context Protocol)를 통해 제공됩니다. GitHub API 없이 네이티브 git 명령어를 사용하여 로컬 저장소를 분석합니다.

도구

Related MCP server: mcp-git

사전 요구 사항

• Node.js >= 18

• Git이 설치되어 PATH에서 사용 가능해야 합니다.

설정

npm install
npm run build

구성

MCP 클라이언트 구성에 추가하세요:

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

도구 상세

git_log

선택적 필터를 사용하여 최근 커밋 기록을 가져옵니다.

매개변수:

• repoPath (필수) — Git 저장소의 절대 경로

• count — 반환할 커밋 수 (기본값: 20)

• author — 작성자 이름 또는 이메일로 필터링

• since / until — 날짜 범위 필터

• path — 특정 파일 또는 디렉터리에 영향을 주는 커밋으로 필터링

git_diff

두 ref를 비교하고 변경 사항의 구조화된 요약을 얻습니다.

매개변수:

• repoPath (필수) — Git 저장소의 절대 경로

• from — 시작 ref (기본값: HEAD~1)

• to — 끝 ref (기본값: HEAD)

• path — diff를 특정 파일 또는 디렉터리로 제한

• summaryOnly — 전체 diff 텍스트 없이 통계만 반환

git_blame

파일의 줄별 작성자를 확인합니다.

매개변수:

• repoPath (필수) — Git 저장소의 절대 경로

• filePath (필수) — 저장소 루트 기준 파일 경로

• startLine / endLine — 특정 줄 범위에 대해 blame

• ref — 특정 커밋에서 blame 수행

git_stats

저장소 활동에 대한 개괄적인 개요를 얻습니다.

매개변수:

• repoPath (필수) — Git 저장소의 절대 경로

• topAuthors — 나열할 상위 기여자 수 (기본값: 10)

• topFiles — 나열할 가장 많이 변경된 파일 수 (기본값: 10)

git_branch

브랜치를 나열하고 분석합니다.

매개변수:

• repoPath (필수) — Git 저장소의 절대 경로

• baseBranch — 비교할 브랜치 (기본값: main 또는 master)

• includeRemote — 원격 추적 브랜치 포함

• mergedOnly / unmergedOnly — 병합 상태로 필터링

라이선스

MIT