git-mcp
무엇인가
GitMCP는 GitHub 프로젝트를 MCP 서버로 감싸 AI 어시스턴트에 연결하는 원격 서비스다. 클라이언트에 설치되는 플러그인이 아니라 클라우드에서 실행되는 서버이며, IDE는 URL 하나를 MCP 서버 목록에 등록하기만 하면 된다. 모델 가중치에 남은 지식이 아니라 저장소 원본을 조회 대상으로 삼는 컨텍스트 공급 계층에 속한다.
어떻게 동작하나
엔드포인트는 세 가지다. 저장소 전용은 `gitmcp.io/{owner}/{repo}`, GitHub Pages 사이트는 `{owner}.gitmcp.io/{repo}`, 임의 저장소를 요청마다 지정하는 동적 서버는 `gitmcp.io/docs`다. AI 어시스턴트가 이 URL에 연결되면 GitMCP는 문서 조회, 스마트 검색, 코드 검색 같은 도구를 MCP 도구 목록으로 노출한다. 사용자가 문서·코드 관련 질문을 던지면 어시스턴트가 승인을 거쳐 해당 도구를 호출하고, GitMCP가 요청을 실행해 데이터를 반환하면 어시스턴트가 그 내용을 근거로 응답을 생성한다.
무엇과 다른가
기존에는 모델이 학습 시점에 담아둔 지식에 의존하거나 문서를 대화에 직접 붙여넣어야 했다. GitMCP는 저장소별 고정 엔드포인트로 대상 프로젝트를 하나로 묶어, 의도하지 않은 다른 저장소에 접근하는 경로를 차단한다. 반대로 동적 엔드포인트는 매 요청마다 대상 저장소를 식별하는 방식이라 여러 저장소를 오갈 때 유연하지만 식별이 정확해야 한다.
어떻게 쓰나
연동은 각 도구의 MCP 설정 파일에 URL을 추가하는 방식이다. Cursor는 `~/.cursor/mcp.json`, Windsurf는 `~/.codeium/windsurf/mcp_config.json`, VSCode는 `.vscode/mcp.json`, Cline은 `cline_mcp_settings.json`을 사용하고, Claude Desktop은 Settings > Developer > Edit Config에서 설정을 바꾼다. Highlight AI와 Augment Code는 커스텀 SSE URL 또는 MCP 서버 항목으로 등록한다. 랜딩 페이지의 변환 도구로 GitHub URL을 MCP URL 형식으로 바꿀 수 있고, 브라우저 안에서 저장소 문서와 바로 대화하는 채팅도 제공한다.
전제와 한계
대상은 GitHub 저장소와 GitHub Pages 사이트로 한정된다. 서버가 클라우드에서 동작하므로 다운로드나 설치, 가입이 필요 없고, 개인정보를 수집하거나 쿼리를 저장하지 않으며 자체 호스팅도 가능하다. 지원하는 문서 종류는 우선순위 순서로 정의되어 있다.
관련 논문 2
유사 도구
- octocode로컬 코드와 GitHub 저장소를 ripgrep·AST·LSP로 검색해 AI 에이전트에 토큰 효율적인 근거 컨텍스트를 돌려주는 Rust 엔진 기반 CLI·MCP 서버다.
- claude-context코드베이스 전체를 벡터 DB에 인덱싱하고 시맨틱 검색으로 관련 코드만 꺼내 Claude Code 등 코딩 에이전트의 컨텍스트에 넣는 MCP 서버다.
- context-modeMCP 서버로 AI 코딩 에이전트의 도구 출력을 샌드박스에 격리해 컨텍스트 사용량을 98% 줄이고, 세션 기억을 SQLite에 남긴다.
- serenaMCP 클라이언트에 연결해 심볼 단위 코드 검색·편집·리팩터링을 제공하는 Python 서버다. 언어 서버로 코드의 의미 구조를 해석한다.
- headroomLLM에 도달하기 전에 도구 출력·로그·파일·RAG 청크를 압축해 토큰을 줄이는 Python 라이브러리 겸 로컬 프록시 겸 MCP 서버다.
- mcp-server-kubernetesKubernetes 클러스터를 MCP 도구로 노출해 AI 에이전트가 kubectl과 Helm 작업을 도구 호출로 수행하게 하는 TypeScript 서버다.