/ 디렉터리 / 플레이그라운드 / GitMCP
● 커뮤니티 idosal ⚡ 바로 사용

GitMCP

제작: idosal · idosal/git-mcp

공개 GitHub 저장소를 라이브 MCP 엔드포인트로 전환합니다. API를 복제하거나 환각시키지 않고 README, 코드 및 문서를 끌어서 Claude로 가져옵니다.

GitMCP는 gitmcp.io/ {owner}/{repo} 에서 원격 MCP 서버를 호스팅합니다. Claude는 문서를 가져오고, 저장소를 검색하고, 파일을 나열하고, 특정 경로를 읽을 수 있는 도구를 가져옵니다. 익숙하지 않은 라이브러리를 사용할 때 "Claude made up a function that does not exist" 클래스의 오류를 제거합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

git-mcp-idosal.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "git-mcp-idosal",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "git-mcp-idosal": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://gitmcp.io/{owner}/{repo}"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add git-mcp-idosal -- npx -y mcp-remote https://gitmcp.io/{owner}/{repo}

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: GitMCP

반쯤 알고 있는 라이브러리에 대한 Claude 환각 API를 중지하는 방법

👤 최신 라이브러리 (사후 차단) 또는 틈새 SDK를 사용하는 개발 ⏱ ~15 min beginner

언제 쓸까: 라이브러리를 통합하고 있고 Claude는 존재하지 않는 메서드 이름을 계속 발명합니다.

사전 조건
  • 라이브러리의 GitHub 경로 파악 — 예: pydantic/pydantic-ai — 소유자/저장소를 gitmcp.io에 붙여넣기
흐름
  1. 라이브러리를 가리키는 GitMCP 추가
    'pydantic/pydantic-ai` 에 대한 GitMCP 서버를 내 구성에 추가한 다음 최상위 문서 파일을 나열합니다.✓ 복사됨
    → 도구가 README.md plus/docs 트리를 반환합니다 — 조작된 경로 없음
  2. 실제 출처에 대해 질문하기
    Pydantic-ai에 대해 GitMCP를 사용하여 Agent 에 대한 실제 생성자 서명을 표시하십시오. 소스에서 인용하고 요약하지 마십시오.✓ 복사됨
    → 소스 파일 + 라인 REF가 있는 정확한 서명
  3. 실행하여 인증하기
    저장소에서 본 것만 사용하여 최소한의 실행 가능한 예제를 작성하십시오. 무언가 빠진 것이 있다면, 그렇게 말하세요. 추측하지 마세요.✓ 복사됨
    → 예제 컴파일; Claude는 누락된 조각을 플래그 지정

결과: 그럴듯하게 들리는 픽션이 아닌 라이브러리의 실제 API와 일치하는 작업 통합.

함정
  • 라이브러리가 monorepo 하위 디렉토리에 있습니다 — 읽기 전에 먼저 트리 도구를 사용하여 올바른 패키지 루트를 찾으십시오
함께 쓰기: context7 · github

포크하기 전에 익숙하지 않은 오픈 소스 저장소를 신속하게 감사합니다.

👤 종속성을 평가하는 엔지니어 ⏱ ~10 min beginner

언제 쓸까: 이제 도서관을 도입하려고 하는데 복제하지 않고도 무엇을 하고 있는지 알고 싶습니다.

흐름
  1. 개요
    owner/repo 에 GitMCP를 사용합니다. README + 최상위 디렉토리의 아키텍처를 8줄로 요약하십시오.✓ 복사됨
    → 마케팅 솜씨가 아닌 구체적인 디렉토리 중심 요약
  2. 위험 스캔
    패키지 매니페스트를 당기고 모든 종속성을 나열합니다. 버려졌거나 알려진 CVE 역사에 플래그를 지정합니다.✓ 복사됨
    → 항목별 평가가 포함된 종속성 표
  3. 적합성 검사
    사용할 수 있는 플러그인/확장 API가 있습니까? 아니면 포크해야 합니까? 코드를 인용하세요.✓ 복사됨
    → 파일 경로가 있는 코드 앵커 답변

결과: 실제 저장소 콘텐츠로 뒷받침되는 5분 포크/채택/건너뛰기 결정.

함정
  • 토큰 없는 비공개 저장소 — 독립 호스트 Docker 이미지를 사용하고 GITHUB_TOKEN 설정
함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

git-mcp-idosal + context7

두 개의 최신 문서 레이어 쌓기 — 공식 SDK 문서의 경우 Context7, 저장소 소스의 경우 GitMCP

Context7이 Foo.bar () 에 대해 말하는 것과 GitMCP를 통해 실제 소스를 비교하십시오. 표류는 없습니까?✓ 복사됨
git-mcp-idosal + github

읽기 전용 문서에는 GitMCP를, PR/이슈 생성에는 GitHub MCP를 사용하세요

GitMCP를 통해 기여 가이드를 읽은 다음 GitHub MCP를 통해 잘 형성된 PR을 엽니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
fetch_documentation owner, repo 낯선 레포를 둘러볼 때 첫 번째 통화 1 GitHub API call
search_documentation owner, repo, query: str 특정 개념을 언급하는 문서 섹션 찾기 1 API call
fetch_url_content url: str 원시 URL로 특정 파일 가져오기 free
search_code owner, repo, query: str 기호가 정의되거나 사용되는 위치 찾기 1 API call

비용 및 제한

운영 비용

API 쿼터
GitHub 인증되지 않음: IP당 60 요청/시간. 인증: 5000 req/h.
호출당 토큰
파일에 따라 500–5000
금액
무료 (호스팅)
전체 파일을 덤핑하는 대신 search_* 도구 사용

보안

권한, 시크릿, 파급범위

최소 스코프: public_repo (for private access)
자격 증명 저장: 독립 호스트 모드에서 env var로 토큰
데이터 외부 송신: gitmcp.io (호스팅됨) 또는 개인 인스턴스
절대 부여 금지: repo:write

문제 해결

자주 발생하는 오류와 해결

403 요금 한도 초과

PAT가 있는 셀프 호스트 또는 대기 — 인증되지 않은 한도는 60요구/시간입니다.

확인: Check X-RateLimit-Remaining header
* 404 repo 없음

소유자/저장소 철자가 공개되어 있는지 확인하십시오. 비공개의 경우, 독립 호스트 이미지를 사용하세요.

잘린 콘텐츠를 반환합니다

GitHub API는 RAW BLOB을 1MB로 제한합니다. 큰 파일에는 SEARCH_CODE를 사용하십시오.

대안

GitMCP 다른 것과 비교

대안언제 쓰나단점/장점
Context7원시 저장소 대신 선별된 라이브러리 문서 표면을 원합니다Context7은 하위 집합만 인덱싱합니다. GitMCP는 모든 공용 저장소를 다룹니다.
GitHub MCP (official)PR/ISSUE/WRITE 작업도 필요합니다GitHub MCP는 쓰기 가능 (잠글 수 있음), GitMCP는 읽기 전용

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기