Git (reference server)의 개요
Git 서버는 MCP 프로젝트가 유지하는 Python 레퍼런스 서버입니다. 2026년 10월 기준으로 메인 modelcontextprotocol/servers 저장소의 서버 일곱 개 중 하나이며, 보관 저장소 servers-archived로 옮겨진 은퇴한 레퍼런스 서버에는 포함되지 않았습니다. 활발히 유지되고 있습니다. PyPI 버전 2026.10.19는 Python SDK 2.x 위에서 다시 만들어졌고, 이제 2025-11-25와 2026-07-28 프로토콜 개정판을 모두 지원합니다.
도구 12개를 노출합니다. git_status, git_diff_unstaged, git_diff_staged, git_diff, git_commit, git_add, git_reset, git_log, git_create_branch, git_checkout, git_show, git_branch입니다. git_init은 없습니다. 2025년 12월의 보안 권고에서 예전 git_init이 디스크 어디에나 저장소를 만들 수 있다는 점이 드러났기 때문입니다.
uvx mcp-server-git --repository path/to/repo, pip, 또는 mcp/git Docker 이미지로 실행합니다. 로컬 저장소에서만 작동하며, 네트워크 도구가 없고 GitHub나 다른 호스트와 통신하지 않습니다.
Git (reference server) 설치 방법
uvx mcp-server-git --repository path/to/repoGit (reference server), 쓸 만한 가치가 있습니까?
이 서버가 제 몫을 하는 상황은 하나입니다. Claude Desktop처럼 셸 명령은 실행할 수 없지만 diff를 읽고 커밋은 할 수 있어야 하는 클라이언트입니다. 그런 곳에서는 타입이 지정된 입력과 일반 텍스트 출력으로 일을 해내며, 호출 이 실패하면 모델이 읽고 바로잡을 수 있는 오류 메시지를 돌려줍니다. Claude Code, Cursor, 또는 터미널이 있는 에이전트에서는 선택지만 적은 git의 중복일 뿐입니다.
범위는 로컬 작업 트리에서 끝납니다. push, pull, fetch, merge, rebase, stash가 없으므로, 모델은 작업을 준비하고 커밋할 수 있지만 공개는 여전히 사람이 합니다. 어떤 팀은 이를 안전 기능으로 여길 것입니다. README는 여전히 이 서버를 초기 개발 단계라고 부르며 도구가 바뀔 수 있다고 경고합니다. 실제로 바뀌었습니다. 2026년 10월의 재구축은 알 수 없는 도구 이름을 보고하는 방식을 바꿨고, 도구 호출을 한 번에 하나씩 실행하게 했습니다.
보안 이력을 보면 최신 버전을 유지하는 편이 낫습니다. mcp-server-git에 대해 공개된 보안 권고는 네 건입니다. 2025년 12월의 심각도 중간 문제 세 건은 git_diff와 git_checkout의 인수 주입, --repository의 경로 검증 누락, 제한 없는 git_init 도구를 다뤘고, 2026년 2월의 git_add 경로 탐색 문제는 저장소 밖의 파일을 스테이징할 수 있었습니다. 모두 수정과 함께 공개되었고, 10월 릴리스는 상위 프로젝트의 권고에 따라 GitPython 3.1.60 이상도 요구합니다.
범위 제한은 플래그가 주는 인상보다 거칩니다. --repository는 저장소 루트까지 올라가므로, 하위 폴더를 가리켜도 저장소 전체에 권한을 주게 됩니다. 플래그를 빼면 호출마다 컴퓨터의 어떤 repo_path든 지정할 수 있습니다. git_reset은 스테이징 해제만 하지만, git_checkout은 저장하지 않은 작업이 있는 편집기 아래에서 브랜치를 바꿀 수 있고, 서버는 확인을 요청하지 않습니다. 그 역할은 클라이언트의 승인 프롬프트가 맡습니다. 여기서 모델이 읽는 것은 사용자 자신의 기록과 파일이어서, 웹 페이지를 가져오는 서버보다 프롬프트 인젝션 표면이 훨씬 작습니다.
제 역할을 하는 곳
Claude Desktop에서 문서 저장소를 편집하는 제품 관리자
지난주 이후 바뀐 내용을 보고 문구 수정을 커밋하기
start_timestamp를 '1 week ago'로 설정한 git_log, main에 대한 git_diff, 그다음 git_add와 git_commit을 씁니다. 무료입니다. 주된 위험은 엉뚱한 브랜치에 커밋하는 것이므로 쓰기 작업에는 승인 프롬프트를 켜 두십시오.
셸 접근 없는 사내 코드 리뷰 에이전트를 만드는 플랫폼 팀
체크아웃된 저장소에서 에이전트가 diff와 기록만 읽게 하기
그 저장소만 마운트한 mcp/git Docker 이미지를 실행하고, 클라이언트에서 읽기 도구(status, diff, log, show, branch)만 허용합니다. 셸을 샌드박스할 필요가 없고, push는 CI에 남습니다.
도입 전 확인할 점
- 설정
- uvx mcp-server-git --repository /path/to/repo, pip install mcp-server-git, 또는 저장소를 바인드 마운트한 mcp/git Docker 이미지를 씁니다. README에 Claude Desktop, VS Code, Zed, Zencoder 설정이 있으며, 클라이언트를 다시 시작하면 도구가 나타납니다.
- 연동
- 도구 12개입니다. 읽기: git_status, git_diff_unstaged, git_diff_staged, git_diff, git_log, git_show, git_branch. 쓰기: git_add, git_commit, git_reset(스테이징 해제만), git_create_branch, git_checkout.
- 데이터와 개인정보
- 사용자의 파일 권한으로 로컬에서 실행되며 네트워크 호출을 하지 않습니다. 하지만 돌려주는 diff와 파일 내용은 클라이언트가 쓰는 모델 제공업체로 갑니다. 2025년 12월부터 2026년 2월 사이의 보안 권고 네 건은 인수 주입, 경로 탐색, 검증되지 않은 저장소 경로를 다뤘습니다.
- 대규모 사용 시 비용
- 무료 오픈소스입니다. 비용은 컨텍스트입니다. git_diff와 git_show는 전체 텍스트를 돌려주므로 큰 diff는 통째로 컨텍스트 창에 들어갑니다. 크기를 조절하는 수단은 context_lines와 max_count뿐입니다.
- 제한
- 원격 작업, stash, merge, blame, tag 도구가 없습니다. stdio 전용이라 원격 서버로 공유할 수 없습니다. 도구 호출이 직렬로 처리되므로 병렬 호출은 대기열에 쌓입니다.
좋은 점
- status, diff, 커밋, 브랜치, log를 위한 타입 지정 도구 12개
- 자체적으로 네트워크 호출을 하지 않습니다
- 활발히 유지되며, 2025-11-25와 2026-07-28 프로토콜 버전을 모두 지원합니다
- 공개된 보안 권고가 빠르게 수정되었습니다
아쉬운 점
- push, pull, merge, rebase, stash가 없습니다
- --repository는 저장소 전체를 범위로 잡고, 빼면 어떤 경로든 허용됩니다
- 여전히 초기 개발 단계로 표시되며, 릴리스마다 동작이 바뀌었습니다
- 터미널이 있는 에이전트에는 불필요합니다
추천 대상
셸 접근 없이 모델이 로컬 변경 사항을 살펴보고 커밋하기를 원하는 채팅형 MCP 클라이언트 사용자입니다.
Git (reference server) 대안
Git (reference server): 자주 묻는 질문
- Git (reference server), 쓸 만한 가치가 있습니까?
- 셸이 없는 채팅 클라이언트에 Git을 주는 깔끔하고 보안 패치가 잘 된 방법입니다. 다만 터미널이 있는 에이전트에는 이미 더 나은 수단이 있습니다. 평점은 5점 만점에 3.8점입니다.
- Git (reference server)의 가격은 얼마입니까?
- 무료 오픈소스입니다.
- Git (reference server)의 단점은 무엇입니까?
- push, pull, merge, rebase, stash가 없습니다; --repository는 저장소 전체를 범위로 잡고, 빼면 어떤 경로든 허용됩니다; 여전히 초기 개발 단계로 표시되며, 릴리스마다 동작이 바뀌었습니다; 터미널이 있는 에이전트에는 불필요합니다.
- Git (reference server)에 적합한 사람은 누구입니까?
- 셸 접근 없이 모델이 로컬 변경 사항을 살펴보고 커밋하기를 원하는 채팅형 MCP 클라이언트 사용자입니다.
- 팀이나 프로덕션 환경에서 Git (reference server)의 비용은 얼마입니까?
- 무료 오픈소스입니다. 비용은 컨텍스트입니다. git_diff와 git_show는 전체 텍스트를 돌려주므로 큰 diff는 통째로 컨텍스트 창에 들어갑니다. 크기를 조절하는 수단은 context_lines와 max_count뿐입니다.
- Git (reference server)에 회사 데이터를 맡겨도 안전합니까?
- 사용자의 파일 권한으로 로컬에서 실행되며 네트워크 호출을 하지 않습니다. 하지만 돌려주는 diff와 파일 내용은 클라이언트가 쓰는 모델 제공업체로 갑니다. 2025년 12월부터 2026년 2월 사이의 보안 권고 네 건은 인수 주입, 경로 탐색, 검증되지 않은 저장소 경로를 다뤘습니다.
- Git (reference server)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 GitHub MCP Server 및 Filesystem (reference server)입니다.
답변 확인일: 2026년 10월 23일.
