깃MCP

🤔 GitMCP란 무엇인가요?

분위기 환각을 멈추고 분위기 코딩을 시작하세요!

GitMCP는 모든 GitHub 프로젝트(저장소 또는 GitHub 페이지)를 문서 허브로 변환하는 무료 오픈 소스 원격 모델 컨텍스트 프로토콜(MCP) 서버입니다. 커서와 같은 AI 도구가 LLM이 접하지 못한 최신 문서와 코드에 접근할 수 있도록 하여 코드 환각 현상을 완벽하게 제거합니다.

GitMCP는 두 가지 유형을 지원합니다.

특정 저장소( gitmcp.io/{owner}/{repo} 또는 {owner}.gitmcp.io/{repo} ): 특정 라이브러리를 주로 사용하는 경우 이 옵션을 사용하세요. 이렇게 하면 AI 어시스턴트가 항상 올바른 프로젝트를 타겟팅하여 의도치 않은 저장소 접근을 방지하고 보안과 관련성을 강화할 수 있습니다.
일반 서버( gitmcp.io/docs ): 여러 저장소를 자주 전환해야 할 때 최대한의 유연성을 위해 이 기능을 사용하세요. AI 어시스턴트는 각 요청 시 어떤 저장소에 접근할지 묻거나 상황에 따라 결정합니다. 이 기능은 매번 대상 저장소를 정확하게 식별해야 한다는 점에 유의하세요.

GitMCP를 사용하면:

AI 보조원은 소스에서 직접 최신 문서와 코드에 액세스합니다.
정확한 API 사용법과 신뢰할 수 있는 코드 예를 얻으세요.
틈새 시장, 신규 도서관 또는 빠르게 변화하는 도서관에서도 효과적으로 작업합니다.
환각이 현저히 감소하고 코드 정확성이 향상되었습니다.

예를 들어, 이 나란히 비교는 three.js 장면을 생성할 때 Cursor에서 동일한 원샷 프롬프트에 대한 결과를 보여줍니다.

https://github.com/user-attachments/assets/fbf1b4a7-f9f0-4c0e-831c-4d64faae2c45

✨ 특징

😎 모든 GitHub 프로젝트의 최신 문서 : AI 비서에게 GitHub 프로젝트 문서 및 코드에 대한 원활한 접근 권한을 부여하세요. 내장된 스마트 검색 기능을 통해 토큰을 너무 많이 사용하지 않고도 AI가 원하는 정보를 정확하게 찾을 수 있습니다!
🧠 환각은 이제 그만 : GitMCP를 사용하면 AI 비서가 사용자의 질문에 정확하고 관련성 있는 답변을 제공할 수 있습니다.
☁️ 설정 불필요 : GitMCP는 클라우드에서 실행됩니다. 선택한 GitMCP URL을 IDE에 MCP 서버로 추가하기만 하면 됩니다. 다운로드, 설치, 가입 또는 변경이 필요하지 않습니다.
💬 내장된 채팅 : 브라우저 내 채팅을 통해 저장소 문서와 직접 채팅하여 빠르게 시작하세요!
✅ 개방적이고 무료이며 비공개 : GitMCP는 오픈 소스이며 완전히 무료로 사용할 수 있습니다. 개인 정보를 수집하거나 쿼리를 저장하지 않으며, 직접 호스팅할 수도 있습니다!

🚀 시작하기

GitMCP 사용은 간단합니다! 다음 단계를 따르세요.

1단계: 원하는 서버 유형을 선택하세요

연결하려는 대상에 따라 다음 URL 형식 중 하나를 선택하세요.

GitHub 저장소의 경우: gitmcp.io/{owner}/{repo}
GitHub Pages 사이트의 경우: {owner}.gitmcp.io/{repo}
모든 저장소(동적)를 지원하는 일반 도구의 경우: gitmcp.io/docs

{owner} GitHub 사용자 이름이나 조직 이름으로, {repo} 저장소 이름으로 바꾸세요.

편의를 위해 랜딩 페이지의 변환 도구를 사용하여 GitHub URL을 MCP URL로 포맷할 수도 있습니다!

2단계: AI 비서 연결

아래 옵션에서 AI 비서를 선택하고 구성 지침을 따르세요.

커서 연결

~/.cursor/mcp.json 에서 커서 구성 파일을 업데이트하세요.

지엑스피1

클로드 데스크톱 연결

Claude Desktop에서 설정 > 개발자 > 구성 편집으로 이동합니다.
구성을 다음으로 바꾸세요.
{ "mcpServers": { "gitmcp": { "command": "npx", "args": [ "mcp-remote", "https://gitmcp.io/{owner}/{repo}" ] } } }

윈드서핑 연결

~/.codeium/windsurf/mcp_config.json 에서 Windsurf 구성 파일을 업데이트하세요.

{
  "mcpServers": {
    "gitmcp": {
      "serverUrl": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

VSCode 연결

.vscode/mcp.json 에서 VSCode 구성 파일을 업데이트하세요.

{
  "servers": {
    "gitmcp": {
      "type": "sse",
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

클라인 연결

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에서 Cline 구성 파일을 업데이트하세요.

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}",
      "disabled": false,
      "autoApprove": []
    }
  }
}

하이라이트 AI 연결

Highlight AI를 열고 사이드바에서 플러그인 아이콘(@ 기호)을 클릭합니다.
사이드바 상단의 설치된 플러그인을 클릭하세요
사용자 정의 플러그인 선택
사용자 정의 SSE URL을 사용하여 플러그인 추가를 클릭합니다.

플러그인 이름: gitmcp SSE URL: https://gitmcp.io/{owner}/{repo}

HighlightAI에 사용자 정의 MCP 서버를 추가하는 방법에 대한 자세한 내용은 설명서 를 참조하세요.

참고: {owner} 와 {repo} 실제 GitHub 사용자 이름/조직 및 저장소 이름으로 바꿔야 합니다. 또한 동적 엔드포인트 https://gitmcp.io/docs )를 사용하여 AI가 필요에 따라 모든 저장소에 액세스하도록 허용할 수 있습니다.

⚙ 작동 원리

GitMCP는 AI 도구가 외부 소스에서 추가 정보를 요청할 수 있도록 하는 표준인 MCP(Model Context Protocol)를 사용하여 AI 어시스턴트를 GitHub 저장소에 연결합니다.

GitMCP를 사용하면 어떤 일이 발생합니까?

AI 비서에 GitMCP URL을 제공합니다 (예: gitmcp.io/microsoft/typescript ). GitMCP는 문서 가져오기, 스마트 검색, 코드 검색 등의 도구를 제공합니다.
AI 비서에게 문서화/코드 관련 질문을 던집니다 .
AI는 (사용자의 승인을 받아) GitMCP에 도구를 사용하기 위한 요청을 보냅니다 .
GitMCP는 AI의 요청을 실행 하고 요청된 데이터를 반환합니다.
AI가 정보를 받아 환각 없이 더 정확하고 현실적인 반응을 생성합니다.

지원되는 문서

GitMCP는 현재 다음 문서를 지원합니다(우선순위 순):

llms.txt
프로젝트 문서의 AI 최적화 버전
README.md /루트

💡 예시

다음은 다양한 AI 어시스턴트와 저장소에서 GitMCP를 사용하는 방법에 대한 몇 가지 예입니다.

예제 1: 특정 저장소와 함께 Windsurf 사용

GitHub 저장소 https://github.com/microsoft/playwright-mcp 에 대해 https://gitmcp.io/microsoft/playwright-mcp Windsurf의 MCP 서버로 추가합니다.

클로드에게 전하는 메시지:

"Playwright MCP를 어떻게 사용하나요?"

Windsurf는 GitMCP에서 관련 문서를 가져와 메모리 기능을 올바르게 구현합니다.

예제 2: GitHub Pages 사이트에서 Cursor 사용

GitHub Pages 사이트 langchain-ai.github.io/langgraph 의 경우 Cursor에 https://langchain-ai.gitmcp.io/langgraph MCP 서버로 추가합니다.

커서로의 프롬프트:

"LangGraph 에이전트에 메모리 추가"

커서는 GitMCP에서 관련 문서와 코드를 가져와 메모리 기능을 올바르게 구현합니다.

예제 3: 동적 엔드포인트와 함께 Claude Desktop 사용

특정 저장소를 선택할 필요는 없습니다. 일반적인 gitmcp.io/docs 엔드포인트를 사용하면 AI가 GitHub 프로젝트를 바로 선택할 수 있습니다!

AI 비서에게 전달되는 메시지:

OpenAI Whisper 음성 인식 모델에 대해 알고 싶습니다. 작동 방식을 설명해 주세요.

클로드는 GitMCP에서 데이터를 가져와서 질문에 답할 것입니다.

🛠️ 도구

GitMCP는 AI 어시스턴트에게 GitHub 저장소에 액세스하고, 이를 이해하고, 쿼리하는 데 도움이 되는 여러 가지 귀중한 도구를 제공합니다.

`fetch_<repo-name>_documentation`

이 도구는 GitHub 저장소에서 주요 문서를 가져옵니다. 관련 문서(예: llms.txt )를 검색하여 작동합니다. 이를 통해 AI는 프로젝트의 전반적인 내용을 파악할 수 있습니다.

유용한 경우: 프로젝트의 목적, 기능 또는 시작 방법에 대한 일반적인 질문의 경우

`search_<repo-name>_documentation`

이 도구는 AI가 특정 검색 쿼리를 입력하여 저장소 문서를 검색할 수 있도록 합니다. 매우 방대한 양의 문서를 모두 불러오는 대신, 지능형 검색 기능을 사용하여 관련 부분만 찾아냅니다.

유용한 경우: 프로젝트 내의 특정 기능, 함수 또는 개념에 대한 구체적인 질문의 경우

`fetch_url_content`

이 도구는 AI가 문서에 언급된 링크에서 정보를 얻을 수 있도록 도와줍니다. 해당 링크의 콘텐츠를 검색하여 AI가 쉽게 읽을 수 있는 형식으로 변환합니다.

유용한 경우: 문서에서 귀하의 질문에 답변하는 데 도움이 될 수 있는 외부 정보를 참조하는 경우

`search_<repo-name>_code`

이 도구는 GitHub의 코드 검색 기능을 활용하여 저장소의 실제 코드를 검색합니다. AI가 특정 코드 예시나 구현 세부 정보를 찾는 데 도움이 됩니다.

유용한 경우: 어떤 것이 어떻게 구현되는지에 대한 예를 원하거나 문서에 포함되지 않은 기술적 세부 사항이 필요한 경우

참고: 동적 엔드포인트( gitmcp.io/docs )를 사용하는 경우 이러한 도구의 이름이 약간 다릅니다( fetch_generic_documentation , search_generic_code , search_generic_documentation ). 또한 액세스할 저장소에 대한 추가 정보가 필요합니다.

📊 배지

GitMCP는 저장소의 README에 배지를 표시합니다. 이를 통해 사용자는 IDE 또는 브라우저(내장된 채팅 기능 사용)를 통해 문서에 빠르게 접근할 수 있습니다. 또한 GitMCP를 통해 문서에 접근한 횟수도 표시됩니다.

예시( idosal/git-mcp ):

저장소에 배지 추가

README.md 에 다음을 추가하세요.

[![GitMCP](https://img.shields.io/endpoint?url=https://gitmcp.io/badge/OWNER/REPO)](https://gitmcp.io/OWNER/REPO)

OWNER GitHub 사용자 이름이나 조직으로 바꾸고, REPO 저장소 이름으로 바꾸세요.

조회수 계산 방법

특정 저장소에 대한 각 도구 호출에 대한 증가입니다.

배지 사용자 정의

다음 매개변수를 사용하여 배지의 모양을 사용자 정의할 수 있습니다.

매개변수	설명	기본	예
`color`	배지 값의 색상	`aquamarine`	`?color=green`
`label`	배지 라벨	`GitMCP`	`Documentation`

연락주세요!

❓ 자주 묻는 질문

모델 컨텍스트 프로토콜이란 무엇인가요?

모델 컨텍스트 프로토콜은 AI 보조자가 외부 소스에서 체계적인 방식으로 추가 컨텍스트를 요청하고 수신하여 이해도와 성능을 향상시킬 수 있도록 하는 표준입니다.

GitMCP는 모든 AI 어시스턴트와 호환되나요?

네, GitMCP는 Cursor, VSCode, Claude 등의 도구를 포함하여 모델 컨텍스트 프로토콜을 지원하는 모든 AI 어시스턴트와 호환됩니다.

GitMCP는 모든 GitHub 프로젝트와 호환됩니까?

물론입니다! GitMCP는 어떠한 수정 없이도 모든 공개 GitHub 저장소와 호환됩니다. llms.txt 파일을 우선시하고, llms.txt 파일을 사용할 수 없는 경우 README.md 또는 다른 페이지로 대체합니다. 향후 업데이트에서는 추가적인 문서화 방법을 지원하고 콘텐츠를 동적으로 생성할 수 있도록 지원할 예정입니다.

GitMCP는 유료인가요?

아니요, GitMCP는 커뮤니티에 무료로 제공되는 서비스이며 관련 비용은 없습니다.

🔒 개인정보 보호

GitMCP는 사용자의 개인정보 보호를 매우 중요하게 생각합니다. 이 서비스는 인증을 요구하지 않으므로 개인 식별 정보에 접근하거나 저장하지 않습니다. 또한, 에이전트가 전송한 쿼리도 저장하지 않습니다. 게다가 GitMCP는 오픈소스 프로젝트이므로 사용자 환경에 독립적으로 배포할 수 있습니다.

GitMCP는 이미 공개적으로 이용 가능한 콘텐츠에만 접근하며, 사용자가 쿼리할 때만 접근합니다. GitMCP는 저장소를 자동으로 스크래핑하지 않습니다. GitHub 페이지 사이트에 접근하기 전에 코드는 robots.txt 규칙을 확인하고 사이트 소유자가 설정한 지침을 따르므로, 사이트 소유자는 접근 거부를 선택할 수 있습니다. GitMCP는 GitHub 프로젝트 또는 콘텐츠 관련 데이터를 영구적으로 저장하지 않습니다.

👥 기여하기

여러분의 기여, 피드백, 아이디어를 환영합니다! 기여 지침을 확인해 주세요.

지역 개발 설정

저장소를 복제합니다
git clone https://github.com/idosal/git-mcp.git cd git-mcp
종속성 설치
pnpm install
개발을 위해 지역적으로 실행하세요
npm run dev # or pnpm dev

테스트를 위해 MCP Inspector 사용

MCP Inspector 도구를 설치하세요:
npx @modelcontextprotocol/inspector
검사기 인터페이스에서:
- 전송 유형을 SSE 로 설정
- GitMCP URL을 입력하세요(예: http://localhost:5173/docs )
- "연결"을 클릭하세요

📄 라이센스

이 프로젝트는 Apache License 2.0 에 따라 라이선스가 부여되었습니다.

부인 성명

GitMCP는 어떠한 보증도 없이 "있는 그대로" 제공됩니다. 당사는 서비스의 안정성과 보안을 보장하기 위해 최선을 다하지만, 서비스 사용으로 인해 발생할 수 있는 어떠한 손상이나 문제에 대해서도 책임을 지지 않습니다. GitMCP를 통해 액세스하는 GitHub 프로젝트는 해당 소유자의 이용 약관을 따릅니다. GitMCP는 GitHub 또는 언급된 AI 도구와 제휴 관계가 없습니다.

Integrations