git — Claude Code MCP 서버

로컬 Git 저장소를 읽고 검색하고 조작하는 공식 reference MCP 서버. status·diff·log·commit·branch 등 Git 작업을 도구로 노출한다. (--repository로 대상 저장소 경로 지정)

git MCP 서버는 Model Context Protocol(MCP) 공식 reference 구현 중 하나로, 로컬 Git 저장소를 AI가 직접 읽고 검색하고 조작할 수 있게 해 주는 서버입니다. Claude Code 같은 MCP 클라이언트에 연결하면, AI가 사람의 손을 거치지 않고 저장소 상태를 파악하고 변경 이력을 추적하며 커밋·브랜치 작업까지 도구(tool) 호출로 수행할 수 있습니다.

핵심은 Git의 일상 작업을 MCP 도구로 노출한다는 점입니다. 대표적으로 워킹 트리 상태 확인(status), 변경 내용 비교(diff), 커밋 이력 조회(log), 변경 사항 커밋(commit), 브랜치 생성·조회 같은 명령을 AI가 호출할 수 있습니다. 덕분에 "지금 무엇이 바뀌었는지 보여 줘", "이 변경을 커밋해 줘", "최근 커밋 이력을 요약해 줘" 같은 자연어 요청을 AI가 실제 Git 동작으로 옮길 수 있습니다. 대상 저장소는 설치 시 --repository로 경로를 지정합니다.

이런 작업이 가능해지면 AI 코딩 워크플로의 마찰이 크게 줄어듭니다. 코드 변경을 만든 뒤 별도 터미널로 전환하지 않고도 diff를 검토하고, 커밋 메시지를 작성해 커밋하고, 작업용 브랜치를 만드는 흐름을 한 대화 안에서 이어갈 수 있습니다. 또 변경 이력·diff를 컨텍스트로 활용해 코드 리뷰, 변경점 요약, 회귀 원인 추적 같은 분석에도 유용합니다.

Python(uvx) 기반으로 동작하는 공식 서버라 도입 장벽이 낮고, MCP 생태계의 표준 동작을 익히는 학습용으로도 적합합니다. AI 에이전트에게 버전 관리 작업을 위임하려는 개발자, Claude Code로 커밋 흐름까지 자동화하려는 사람, MCP를 처음 시험해 보려는 사용자에게 권장됩니다. 사용 가능한 정확한 도구 목록과 인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.

언제 쓰나

Claude Code에서 코드 변경 후 별도 터미널 없이 diff 검토·커밋·브랜치 작업까지 한 흐름으로 처리하고 싶을 때 적합합니다. AI에게 커밋 메시지 작성과 커밋 실행을 맡기거나, 변경 이력·diff를 컨텍스트로 한 코드 리뷰·변경점 요약·회귀 추적을 자동화할 때 유용합니다. MCP를 처음 익히는 학습용으로도 좋습니다. 단, 원격 호스팅(GitHub·GitLab) API 연동이 목적이라면 전용 서버가 더 맞습니다.

설치

claude mcp add git -- uvx mcp-server-git --repository /path/to/repo

Python 실행기 uvx(uv 패키지에 포함)가 필요하므로 uv를 먼저 설치하세요. 설치 명령의 --repository에는 대상 Git 저장소의 실제 절대 경로를 넣어야 하며, 지정한 경로가 유효한 Git 저장소여야 도구가 정상 동작합니다. 여러 저장소를 다루려면 별칭을 달리해 여러 인스턴스로 등록하는 방식을 고려하세요. 설치 후 Claude Code에서 도구 노출 여부를 확인하고, 제공 도구 목록·인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.

보안 주의

이 서버는 별도 API 키나 비밀키를 요구하지 않지만, 지정한 로컬 저장소에 대한 파일 읽기 및 Git 쓰기 권한을 AI에 부여합니다. commit·branch 등 상태를 변경하는 도구가 노출되므로, AI가 의도치 않게 커밋을 만들거나 브랜치를 바꿀 수 있습니다. 따라서 신뢰하는 저장소 경로만 --repository로 지정하고, 비밀키·인증서·.env 등 민감 파일이 포함된 디렉터리는 주의하세요. diff·log·파일 내용에 포함된 외부 텍스트가 프롬프트 인젝션 경로가 될 수 있으니, AI가 제안한 커밋·변경은 적용 전 사람이 검토하길 권장합니다.

자주 묻는 질문

git MCP 서버로 어떤 Git 작업을 할 수 있나요?

워킹 트리 상태 확인(status), 변경 비교(diff), 커밋 이력 조회(log), 커밋(commit), 브랜치 생성·조회 같은 일상 Git 작업을 도구로 노출합니다. 정확한 도구 목록과 인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.

어떤 저장소를 대상으로 동작하나요?

설치 시 --repository로 지정한 로컬 Git 저장소의 절대 경로를 대상으로 동작합니다. 여러 저장소를 다루려면 별칭을 달리해 여러 인스턴스로 등록하는 방식을 고려하세요.

GitHub나 GitLab 같은 원격 서비스도 연동되나요?

이 서버는 로컬 Git 저장소 조작에 초점을 둔 reference 서버입니다. 원격 호스팅 서비스의 PR·이슈 등 API 연동이 필요하면 GitLab Duo 같은 전용 MCP 서버를 함께 고려하는 것이 적합합니다.