GitMCP
- 추천0
- GitHub 별8.5K
- 개발원격 연결라이선스Apache-2.0
GitHub 저장소를 문서 허브로 바꿔 AI가 최신 문서와 코드를 읽게 하는 원격 MCP 서버. Apache-2.0
연결 · 설치 방법은 설치 탭에 정리했어요.
설명
GitMCP
🤔 GitMCP란?
바이브 환각은 그만, 바이브 코딩을 시작하세요!
GitMCP는 어떤 GitHub 프로젝트(저장소나 GitHub Pages)든 문서 허브로 바꿔 주는 무료 오픈소스 원격 Model Context Protocol(MCP) 서버입니다. LLM이 한 번도 본 적 없는 프로젝트라도 Cursor 같은 AI 도구가 최신 문서와 코드를 읽을 수 있게 해 주므로, 코드 환각을 자연스럽게 없애 줍니다.
GitMCP는 두 가지 방식을 지원합니다.
- 특정 저장소(
gitmcp.io/{owner}/{repo}또는{owner}.gitmcp.io/{repo}): 몇 개 안 되는 라이브러리를 주로 쓸 때 쓰세요. AI 비서가 늘 알맞은 프로젝트를 대상으로 삼게 하고, 의도하지 않은 저장소에 접근하지 못하게 막아 보안과 관련성을 높여 줍니다. - 범용 서버(
gitmcp.io/docs): 저장소를 자주 바꿔야 할 때 최대한 유연하게 쓰세요. 요청마다 어느 저장소에 접근할지 AI 비서가 (사용자에게 묻거나 맥락에 따라) 정합니다. 매번 대상 저장소를 제대로 알아내는 데 기댄다는 점을 유념하세요.
GitMCP를 쓰면:
- AI 비서가 출처에서 최신 문서와 코드를 직접 읽습니다.
- 정확한 API 사용법과 믿을 수 있는 코드 예제를 얻습니다.
- 잘 알려지지 않았거나 새롭거나 빠르게 바뀌는 라이브러리에서도 잘 작동합니다.
- 환각이 크게 줄고 코드 정확도가 올라갑니다.
예를 들어, 아래 나란히 놓은 비교 영상은 Cursor에서 같은 한 줄 프롬프트로 three.js 장면을 만들 때의 결과를 보여 줍니다.
✨ 기능
- 😎 어떤 GitHub 프로젝트든 최신 문서: AI 비서가 GitHub 프로젝트의 문서와 코드에 막힘없이 접근하게 합니다. 내장된 똑똑한 검색이 토큰을 많이 쓰지 않고도 AI에게 필요한 것을 딱 찾아 줍니다!
- 🧠 환각은 이제 그만: GitMCP가 있으면 AI 비서가 질문에 정확하고 알맞은 답을 줄 수 있습니다.
- ☁️ 설치 필요 없음: GitMCP는 클라우드에서 돌아갑니다. 고른 GitMCP 주소를 IDE에 MCP 서버로 추가하기만 하면 됩니다. 내려받기, 설치, 가입, 변경이 필요 없습니다.
- 💬 내장 채팅: 브라우저 안의 채팅으로 저장소 문서와 바로 대화하며 빠르게 시작하세요!
- ✅ 공개, 무료, 비공개: GitMCP는 오픈소스이고 완전히 무료입니다. 개인정보를 수집하거나 질의를 저장하지 않습니다. 직접 호스팅할 수도 있습니다!
🚀 시작하기
GitMCP는 쉽게 쓸 수 있습니다! 아래 단계를 따라 하세요.
1단계: 원하는 서버 종류 고르기
연결하려는 대상에 따라 다음 주소 형식 중 하나를 고르세요.
- GitHub 저장소:
gitmcp.io/{owner}/{repo} - GitHub Pages 사이트:
{owner}.gitmcp.io/{repo} - 모든 저장소를 지원하는 범용(동적) 도구:
gitmcp.io/docs
{owner}는 GitHub 사용자 이름이나 조직 이름으로, {repo}는 저장소 이름으로 바꾸세요.
편의를 위해, 랜딩 페이지의 변환 도구로 GitHub 주소를 MCP 주소로 바꿀 수도 있습니다!
2단계: AI 비서 연결하기
아래에서 쓰는 AI 비서를 고르고 설정 안내를 따르세요.
Cursor 연결
~/.cursor/mcp.json에 있는 Cursor 설정 파일을 고치세요.
{
"mcpServers": {
"gitmcp": {
"url": "https://gitmcp.io/{owner}/{repo}"
}
}
}
Claude Desktop 연결
- Claude Desktop에서 Settings > Developer > Edit Config로 갑니다
- 설정을 다음으로 바꿉니다.
{
"mcpServers": {
"gitmcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}
Windsurf 연결
~/.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}"
}
}
}
Cline 연결
~/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": []
}
}
}
Highlight AI 연결
- 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 연결
- Augment Code 설정을 엽니다
- MCP 항목으로 갑니다
- 다음 내용으로 새 MCP 서버를 추가합니다
MCP 서버 이름: git-mcp Docs
이 명령을 쓰세요.
npx mcp-remote https://gitmcp.io/{owner}/{repo}
또는 다음 설정을 쓰세요.
{
"mcpServers": {
"git-mcp Docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}
Msty AI 연결
- Msty Studio를 엽니다
- Tools > Import Tools from JSON Clipboard로 갑니다
- 다음 설정을 붙여 넣습니다
{
"mcpServers": {
"git-mcp Docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://gitmcp.io/{owner}/{repo}"
]
}
}
}
Augment Code에서 MCP 서버를 설정하는 방법은 Augment Code 문서를 보세요.
💡 참고
{owner}와{repo}를 실제 GitHub 사용자 이름이나 조직 이름, 저장소 이름으로 바꾸는 것을 잊지 마세요. 동적 엔드포인트https://gitmcp.io/docs를 쓰면 AI가 필요할 때마다 어떤 저장소든 접근하게 할 수도 있습니다.
⚙ 작동 방식
GitMCP는 AI 도구가 외부에서 추가 정보를 요청하게 해 주는 표준인 Model Context Protocol(MCP)로 AI 비서를 GitHub 저장소에 연결합니다.
GitMCP를 쓸 때 일어나는 일:
- GitMCP 주소를 AI 비서에게 줍니다(예:
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 서버로 추가하세요.
Claude에게 하는 프롬프트:
"Playwright MCP는 어떻게 써?"
Windsurf가 GitMCP에서 관련 문서를 가져와 메모리 기능을 올바르게 구현합니다.
예시 2: GitHub Pages 사이트와 함께 Cursor 쓰기
GitHub Pages 사이트 langchain-ai.github.io/langgraph라면 https://langchain-ai.gitmcp.io/langgraph를 Cursor의 MCP 서버로 추가하세요.
Cursor에게 하는 프롬프트:
"내 LangGraph 에이전트에 메모리를 추가해 줘"
Cursor가 GitMCP에서 관련 문서와 코드를 가져와 메모리 기능을 올바르게 구현합니다.
예시 3: 동적 엔드포인트와 함께 Claude Desktop 쓰기
특정 저장소를 미리 골라 둘 필요가 없습니다. 범용 gitmcp.io/docs 엔드포인트를 쓰면 AI가 그때그때 GitHub 프로젝트를 고릅니다!
아무 AI 비서에게 하는 프롬프트:
"OpenAI Whisper 음성 인식 모델에 대해 알고 싶어. 어떻게 작동하는지 설명해 줘."
Claude가 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로 문서에 접근한 횟수도 보여 줍니다.
내 저장소에 배지 추가하기
README.md에 다음을 추가하세요.
[](https://gitmcp.io/OWNER/REPO)
OWNER는 GitHub 사용자 이름이나 조직 이름으로, REPO는 저장소 이름으로 바꾸세요.
조회수를 세는 방법
해당 저장소에서 도구를 호출할 때마다 1씩 올립니다.
배지 꾸미기
매개변수로 배지 모양을 바꿀 수 있습니다.
| 매개변수 | 설명 | 기본값 | 예시 |
|---|---|---|---|
color | 배지 값의 색 | aquamarine | ?color=green |
label | 배지 라벨 | GitMCP | Documentation |
도움이 필요하면 연락 주세요!
❓ 자주 묻는 질문
Model Context Protocol이 뭔가요?
Model Context Protocol은 AI 비서가 외부 출처에서 추가 맥락을 구조화된 방식으로 요청하고 받게 해 주는 표준으로, AI의 이해력과 성능을 높여 줍니다.
GitMCP는 어떤 AI 비서와도 쓸 수 있나요?
네, GitMCP는 Cursor, VSCode, Claude 등을 포함해 Model Context Protocol을 지원하는 모든 AI 비서와 호환됩니다.
GitMCP는 모든 GitHub 프로젝트와 호환되나요?
물론입니다! GitMCP는 어떤 공개 GitHub 저장소와도 수정 없이 작동합니다. llms.txt 파일을 우선으로 보고, 없으면 README.md나 다른 페이지로 넘어갑니다. 앞으로 문서를 얻는 방법을 더 지원하고 내용을 동적으로 만들어 내는 것까지 목표로 합니다.
GitMCP는 돈이 드나요?
아니요, GitMCP는 비용 없이 커뮤니티에 제공하는 무료 서비스입니다.
🔒 개인정보
GitMCP는 사용자의 개인정보를 깊이 신경 씁니다. 인증이 필요 없으므로 개인을 식별할 수 있는 정보에 접근하거나 저장하지 않습니다. 또 에이전트가 보낸 질의도 저장하지 않습니다. 게다가 GitMCP는 오픈소스라서 내 환경에 독립적으로 배포할 수 있습니다.
GitMCP는 이미 공개된 내용에만, 그것도 사용자가 질의할 때만 접근합니다. 저장소를 자동으로 긁어 가지 않습니다. GitHub Pages 사이트에 접근하기 전에는 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 -
인스펙터 화면에서:
- Transport Type을
SSE로 설정합니다 - GitMCP 주소(예:
http://localhost:5173/docs)를 입력합니다 - "Connect"를 누릅니다
- Transport Type을
📄 라이선스
이 프로젝트는 Apache License 2.0으로 배포됩니다.
면책 조항
GitMCP는 어떤 종류의 보증도 없이 "있는 그대로" 제공됩니다. 서비스의 안정성과 보안을 확실히 하려고 노력하지만, 사용으로 생길 수 있는 어떤 피해나 문제에도 책임지지 않습니다. GitMCP로 접근하는 GitHub 프로젝트에는 각 소유자의 이용 약관이 적용됩니다. GitMCP는 GitHub나 언급된 어떤 AI 도구와도 제휴 관계가 아닙니다.