GitMCP 소개 및 기능 안내

GitMCP란 무엇인가 • 기능 • 시작하기 • 작동 원리 • 배지 • 예시 • FAQ • 개인정보 보호 • 기여하기 • 라이선스

막연한 추측(vibe-hallucinating)을 멈추고, 느낌 있는 코딩(vibe-coding)을 시작하세요!

GitMCP는 어떠한 GitHub 프로젝트(저장소 또는 GitHub Pages)도 문서 허브로 변환해 주는 무료 오픈 소스 원격 Model Context Protocol (MCP) 서버입니다. 이를 통해 Cursor와 같은 AI 도구가 LLM이 한 번도 접해보지 못한 최신 문서와 코드에 접근할 수 있게 하여, 코드 환각(hallucination) 현상을 매끄럽게 제거합니다.

GitMCP는 두 가지 방식을 지원합니다 -

특정 저장소 방식 (Specific Repository) (주로 선택된 소수의 라이브러리를 작업할 때 사용하세요. 이를 통해 AI 어시스턴트가 항상 정확한 프로젝트를 대상으로 삼도록 보장하며, 의도하지 않은 저장소에 대한 접근을 방지하여 보안과 관련성을 높일 수 있습니다. gitmcp.io/{owner}/{repo} 또는 {owner}.gitmcp.io/{repo})

범용 서버 방식 (Generic Server) (다양한 저장소 사이를 빈번하게 전환해야 할 때 최대의 유연성을 위해 사용하세요. AI 어시스턴트가 각 요청에 대해 어떤 저장소에 접근할지 사용자에게 묻거나 (또는 문맥에 따라 결정합니다). 매번 대상 저장소를 정확하게 식별해야 한다는 점에 유의하세요. gitmcp.io/docs)

GitMCP를 사용하면:

• AI 어시스턴트가 소스에서 직접 최신 문서와 코드에 접근합니다.
• 정확한 API 사용법과 신뢰할 수 있는 코드 예시를 얻을 수 있습니다.
• 니치(niche)한 라이브러리, 새로운 라이브러리, 또는 빠르게 변화하는 라이브러리에서도 효과적으로 작업할 수 있습니다.
• 환각(hallucination)이 현저히 줄어들고 코드 정확도가 향상됩니다.

예를 들어, 다음의 나란히 비교한 영상은 Cursor에서 three.js 장면을 생성할 때 동일한 원샷 프롬프트(one-shot prompt)를 사용한 결과입니다 -

GitMCP-threejs.mov

• 😎
  모든 GitHub 프로젝트에 대한 최신 문서 (Latest Documentation on ANY GitHub Project): AI 어시스턴트에게 GitHub 프로젝트의 문서와 코드에 대한 원활한 접근 권한을 부여하세요. 내장된 스마트 검색 (smart search) 기능은 너무 많은 토큰 (tokens)을 사용하지 않고도 AI가 정확히 필요한 정보를 찾을 수 있도록 도와줍니다! - 🧠
  환각 현상 제거 (No More Hallucinations): GitMCP를 사용하면 AI 어시스턴트가 질문에 대해 정확하고 관련성 있는 답변을 제공할 수 있습니다. - ☁️
  설정 불필요 (Zero Setup): GitMCP는 클라우드 (cloud)에서 실행됩니다. 선택한 GitMCP URL을 IDE의 MCP 서버로 추가하기만 하면 됩니다. 다운로드, 설치, 회원가입 또는 변경 사항이 필요하지 않습니다. - 💬
  임베디드 채팅 (Embedded Chat): 브라우저 내 채팅을 통해 저장소 (repository)의 문서와 직접 채팅하며 빠르게 시작해 보세요! - ✅
  개방형, 무료 및 프라이버시 보호 (Open, Free, and Private): GitMCP는 오픈 소스 (open-source)이며 완전히 무료로 사용할 수 있습니다. 개인 정보를 수집하거나 쿼리 (queries)를 저장하지 않습니다. 직접 셀프 호스팅 (self-host)할 수도 있습니다!

GitMCP_PW.mp4

GitMCP를 사용하는 방법은 간단합니다! 다음 단계를 따르세요:

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

• GitHub 저장소 (repositories)의 경우:
  gitmcp.io/{owner}/{repo}

• GitHub Pages 사이트의 경우:
  {owner}.gitmcp.io/{repo}

• 모든 저장소를 지원하는 범용 도구 (dynamic)의 경우:
  gitmcp.io/docs

{owner}는 GitHub 사용자 이름 또는 조직 (organization) 이름으로, {repo}는 저장소 이름으로 바꾸세요.

편의를 위해 랜딩 페이지에 있는 변환 도구를 사용하여 GitHub URL을 MCP URL로 형식을 맞출 수도 있습니다!

아래 옵션에서 AI 어시스턴트를 선택하고 구성 (configuration) 지침을 따르세요:

~/.cursor/mcp.json에 있는 Cursor 구성 파일을 업데이트하세요:

{
"mcpServers": {
"gitmcp": {
...

• Claude Desktop의 경우, Settings > Developer > Edit Config로 이동하세요.
• 구성을 다음으로 교체하세요:
  { "mcpServers": { "gitmcp": { "command": "npx", "args": [ "mcp-remote", "https://gitmcp.io/{owner}/{repo}" ] } } }

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

{
"mcpServers": {
"gitmcp": {
...

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

:

{
"servers": {
"gitmcp": {
...

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

:

{
"mcpServers": {
"gitmcp": {
...

• Highlight AI를 열고 사이드바에 있는 플러그인 아이콘 (@ 기호)을 클릭하세요.
• 사이드바 상단의 Installed Plugins를 클릭하세요. - Custom Plugin을 선택하세요. - Add a plugin using a custom SSE URL을 클릭하세요.

플러그인 이름: gitmcp

SSE URL: https://gitmcp.io/{owner}/{repo}

HighlightAI에 커스텀 MCP 서버를 추가하는 방법에 대한 자세한 내용은 문서를 참조하세요.

• Augment Code 설정을 엽니다.
• MCP 섹션으로 이동합니다.
• 다음 세부 정보로 새로운 MCP 서버를 추가합니다:

MCP 서버 이름: git-mcp Docs

다음 명령어를 사용하세요:

npx mcp-remote https://gitmcp.io/{owner}/{repo}

또는 다음 구성을 사용하세요:

{
"mcpServers": {
"git-mcp Docs": {
...

• Msty Studio를 엽니다.
• Tools > Import Tools from JSON Clipboard로 이동합니다.
• 다음 구성을 붙여넣으세요:

{
"mcpServers": {
"git-mcp Docs": {
...

Augment Code에서 MCP 서버를 구성하는 방법에 대한 자세한 내용은 Augment Code 문서를 방문하세요.

참고: {owner}와 {repo}를 실제 GitHub 사용자 이름/조직(organization) 및 리포지토리(repository) 이름으로 교체해야 함을 기억하세요. 또한 AI가 필요할 때마다 모든 리포지토리에 액세스할 수 있도록 동적 엔드포인트(dynamic endpoint)인 https://gitmcp.io/docs를 사용할 수도 있습니다.

GitMCP는 AI 도구가 외부 소스로부터 추가 정보를 요청할 수 있도록 하는 표준인 모델 컨텍스트 프로토콜 (Model Context Protocol, MCP)을 사용하여 AI 어시스턴트를 GitHub 리포지토리에 연결합니다.

GitMCP를 사용할 때 발생하는 일:

AI 어시스턴트에게 GitMCP URL을 제공합니다 (예: gitmcp.io/microsoft/typescript)

). GitMCP는 문서 가져오기 (documentation fetching), 스마트 검색 (smart search), 코드 검색 (code search) 등의 도구를 제공합니다.AI 어시스턴트에게 프롬프트(Prompt)를 입력합니다 문서/코드 관련 질문을 던집니다.사용자의 AI가 GitMCP에 요청을 보냅니다 (사용자의 승인 하에) GitMCP의 도구를 사용하기 위해 요청을 보냅니다.GitMCP가 AI의 요청을 실행합니다 그리고 요청된 데이터를 반환합니다.사용자의 AI가 정보를 수신합니다 그리고 환각 (hallucinations) 없이 더 정확하고 근거 있는 (grounded) 응답을 생성합니다.

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

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

/root

다음은 다양한 AI 어시스턴트 및 리포지토리(repository)에서 GitMCP를 사용하는 몇 가지 예시입니다:

GitHub 리포지토리 https://github.com/microsoft/playwright-mcp 의 경우, https://gitmcp.io/microsoft/playwright-mcp 를 Windsurf의 MCP 서버로 추가합니다.

Claude에게 보내는 프롬프트:

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

Windsurf는 메모리 기능을 올바르게 구현하기 위해 GitMCP로부터 관련 문서를 가져옵니다.

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

Cursor에게 보내는 프롬프트:

"내 LangGraph 에이전트에 메모리를 추가해줘"

Cursor는 메모리 기능을 올바르게 구현하기 위해 GitMCP로부터 관련 문서와 코드를 가져옵니다.

특정 리포지토리를 직접 선택할 필요는 없습니다. 범용적인 gitmcp.io/docs 엔드포인트를 통해 AI가 즉석에서 GitHub 프로젝트를 선택할 수 있습니다!

모든 AI 어시스턴트에게 보내는 프롬프트:

"OpenAI Whisper 음성 인식 모델에 대해 배우고 싶습니다. 어떻게 작동하는지 설명해 주세요."

Claude는 GitMCP에서 데이터를 가져와 질문에 답변합니다.

GitMCP는 AI 어시스턴트가 GitHub 리포지토리에 접근하고, 이해하며, 쿼리(query)할 수 있도록 돕는 여러 가지 가치 있는 도구들을 제공합니다.

이 도구는 GitHub 리포지토리에서 주요 문서를 가져옵니다. 이는 관련 문서(예: llms.txt)를 검색함으로써 작동합니다. 이를 통해 AI는 프로젝트가 무엇에 관한 것인지에 대한 좋은 개요를 얻을 수 있습니다.

유용한 경우: 프로젝트의 목적, 기능 또는 시작 방법(get started)에 대한 일반적인 질문이 있을 때

이 도구는 특정 검색 쿼리(search query)를 제공함으로써 AI가 저장소(repository)의 문서를 검색할 수 있게 합니다. 모든 문서를 불러오는 대신(이는 매우 클 수 있습니다), 지능형 검색을 사용하여 관련 있는 부분만 찾아냅니다.

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

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

유용한 경우: 문서가 질문에 답변하는 데 도움이 될 외부 정보를 참조하고 있을 때

이 도구는 GitHub의 코드 검색(code search)을 사용하여 저장소 내의 실제 코드를 검색합니다. 이는 AI가 특정 코드 예시나 구현 세부 사항을 찾는 데 도움을 줍니다.

유용한 경우: 무언가가 어떻게 구현되었는지에 대한 예시가 필요하거나 문서에 포함되지 않은 기술적 세부 사항이 필요할 때

참고: 동적 엔드포인트(gitmcp.io/docs)를 사용할 때, 이 도구들은 약간 다른 이름(fetch_generic_documentation, search_generic_code, search_generic_documentation)으로 명명되며, 어떤 저장소에 접근해야 하는지에 대한 추가 정보가 필요합니다.

GitMCP는 귀하의 저장소 README를 위한 배지(badge)를 제공합니다. 이를 통해 사용자는 IDE 또는 브라우저(임베디드 채팅 사용)를 통해 귀하의 문서에 빠르게 접근할 수 있습니다. 또한 GitMCP를 통해 귀하의 문서가 얼마나 많이 액세스되었는지 보여줍니다.

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

[](https://gitmcp.io/OWNER/REPO)

OWNER를 귀하의 GitHub 사용자 이름 또는 조직(organization)으로, REPO를 저장소 이름으로 바꾸세요.

특정 저장소에 대한 각 도구 호출(tool call)마다 수치가 증가합니다.

매개변수(parameters)를 사용하여 배지의 모양을 사용자 정의할 수 있습니다:

매개변수 (Parameter)	설명 (Description)	기본값 (Default)	예시 (Example)
color	배지 값의 색상	aquamarine	?color=green
label	배지 라벨	GitMCP	Documentation

도움이 필요하시면 언제든 문의해 주세요!

Model Context Protocol (MCP)은 AI 어시스턴트가 외부 소스로부터 추가적인 컨텍스트 (context)를 구조화된 방식으로 요청하고 받을 수 있도록 하는 표준으로, AI의 이해도와 성능을 향상시킵니다.

네, GitMCP는 Cursor, VSCode, Claude 등 Model Context Protocol을 지원하는 모든 AI 어시스턴트와 호환됩니다.

물론입니다! GitMCP는 어떠한 수정 없이도 모든 공개 GitHub 저장소 (public GitHub repository)에서 작동합니다. GitMCP는 llms.txt 파일을 우선적으로 고려하며, 해당 파일이 없는 경우 README.md 또는 다른 페이지를 대체 수단으로 사용합니다. 향후 업데이트를 통해 추가적인 문서화 방법 지원 및 콘텐츠의 동적 생성 기능까지 제공하는 것을 목표로 하고 있습니다.

아니요, GitMCP는 커뮤니티를 위한 무료 서비스이며 관련 비용이 발생하지 않습니다.

GitMCP는 사용자의 개인정보 보호를 최우선으로 합니다. 인증이 필요하지 않기 때문에 서비스는 어떠한 개인 식별 정보 (personally identifiable information)에도 접근하거나 저장하지 않습니다. 또한, 에이전트 (agents)가 전송하는 쿼리 (queries)를 저장하지 않습니다. 더욱이 GitMCP는 오픈 소스 (open-source) 프로젝트이므로, 사용자의 환경에 독립적으로 배포할 수 있습니다.

GitMCP는 이미 공개적으로 사용 가능한 콘텐츠에만 접근하며, 사용자의 요청이 있을 때만 접근합니다. GitMCP는 저장소를 자동으로 스크래핑 (scrape)하지 않습니다. GitHub Pages 사이트에 접근하기 전에 코드는 robots.txt 규칙을 확인하고 사이트 소유자가 설정한 지침을 따르므로, 소유자는 거부 (opt out)할 수 있습니다. GitMCP는 GitHub 프로젝트나 그 콘텐츠에 관한 데이터를 영구적으로 저장하지 않는다는 점을 유의해 주세요.

기여 (contributions), 피드백, 그리고 아이디어를 환영합니다! 저희의 기여 가이드라인 (contribution guidelines)을 검토해 주세요.

저장소 복제 (Clone the repository)
git clone https://github.com/idosal/git-mcp.git cd git-mcp

의존성 설치 (Install dependencies)
pnpm install

개발을 위한 로컬 실행 (Run locally for development)
npm run dev # 또는 pnpm dev

MCP Inspector 도구를 설치합니다:

npx @modelcontextprotocol/inspector

Inspector 인터페이스에서:

• Transport Type (전송 유형)을 SSE로 설정합니다.

• GitMCP URL을 입력합니다 (예: http://localhost:5173/docs).

• "Connect"를 클릭합니다.

• Transport Type (전송 유형)을 설정합니다.

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

GitMCP는 어떠 종류의 보증 없이 "있는 그대로" 제공됩니다. 당사는 서비스의 신뢰성과 보안을 보장하기 위해 노력하지만, 사용으로 인해 발생할 수 있는 어떠한 손해나 문제에 대해서도 책임을 지지 않습니다. GitMCP를 통해 접속하는 GitHub 프로젝트는 각 소유자의 이용 약관을 따릅니다. GitMCP는 GitHub 또는 언급된 어떠한 AI 도구와도 관련이 없습니다.