Integrations
Enables browsing public GitHub repositories, navigating through directories, and viewing file contents with tools for listing repository files and fetching specific file data.
GitHub 리포 MCP
목차
✨ 주요 특징
- 💻
stdio프로토콜을 지원하는 Cursor, Windsurf, Claude Desktop 및 기타 MCP 클라이언트와 호환됩니다. - 🔎 모든 공개 GitHub 저장소의 콘텐츠를 탐색하세요
- 📂 저장소 디렉토리 및 하위 디렉토리 탐색
- 📝 코드 및 텍스트 파일의 내용 보기
- 📦 패키지 관리자를 통한 간편한 설치
시작하기
필수 조건
서버를 설치하려면 시스템에 다음이 필요합니다.
- 노드.js 18+
- npm 또는 yarn
1단계. 설치
Smithery, NPX를 사용하거나 IDE의 mcp.json을 설정하여 GitHub Repo MCP를 설치하고 실행할 수 있습니다.
맥OS
지엑스피1
윈도우 NPX
.cursor/mcp.json을 통한 Windows NPX
.cursor/mcp.json을 통한 Windows NPX(경로가 설정되지 않은 경우)
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 GitHub Repo MCP를 자동으로 설치하려면:
몇 초 정도 기다리거나, 등록되지 않으면 새로 고침 버튼을 몇 번 클릭하세요. 그래도 등록되지 않으면 명령어를 제대로 입력했는지 확인하세요.
2단계. 구성
GitHub Repo MCP 서버는 GitHub API에 액세스할 때 더 높은 속도 제한을 위해 GitHub 토큰을 사용할 수 있습니다.
환경 변수
| 변하기 쉬운 | 필수의 | 기본 | 설명 |
|---|---|---|---|
GITHUB_TOKEN | 아니요 | 없음 | 더 높은 요금 제한을 위한 GitHub 개인 액세스 토큰 |
GitHub 토큰 설정(선택 사항)
서버는 인증 없이 작동하지만, GitHub API는 인증되지 않은 요청에 대해 훨씬 낮은 속도 제한을 적용합니다. 속도 제한을 높이려면:
- https://github.com/settings/tokens 에서 개인 액세스 토큰을 생성하세요.
- mcp.json에서 토큰을 환경 변수로 설정합니다.
기능 개요
저장소 탐색 도구
이 서버는 GitHub 저장소와 상호 작용하기 위한 세 가지 주요 도구를 제공합니다.
1. getRepoAllDirectories
GitHub 저장소 루트에 있는 모든 파일과 디렉토리를 나열합니다.
- 매개변수 :
repoUrl: GitHub 저장소의 URL(예: " https://github.com/owner/repo ")
2. getRepoDirectories
GitHub 저장소의 특정 디렉토리의 내용을 나열합니다.
- 매개변수 :
repoUrl: GitHub 저장소의 URLpath: 가져올 디렉토리 경로(예: "src")
3. getRepoFile
GitHub 저장소에서 특정 파일의 내용을 검색하여 표시합니다.
- 매개변수 :
repoUrl: GitHub 저장소의 URLpath: 가져올 파일 경로(예: "src/index.js")
사용 예
다음은 AI 도우미와 함께 이러한 도구를 사용하는 방법에 대한 몇 가지 예입니다.
- 저장소 루트 탐색 : AI 비서에게 " https://github.com/Ryan0204/github-repo-mcp 에 있는 저장소의 내용을 보여주세요"라고 요청하세요.
- 특정 디렉토리 탐색 : " https://github.com/Ryan0204/github-repo-mcp 의 src 디렉토리에 어떤 파일이 있나요?"라고 질문해 보세요.
- 파일 보기 : " https://github.com/Ryan0204/github-repo-mcp 에서 README.md 파일을 보여주세요"라고 요청합니다.
제한 사항
- 속도 제한 : 인증 없이 GitHub API는 엄격한 속도 제한(시간당 60개 요청)을 갖습니다.
- 개인 저장소 : 적절한 권한이 있는 토큰이 제공되지 않는 한 공개 저장소에만 액세스할 수 있습니다.
- 바이너리 파일 : 서버는 일반적인 바이너리 파일 확장자를 감지하고 해당 내용을 표시하지 않습니다.
- 대용량 파일 : GitHub API에는 검색할 수 있는 파일 크기에 제한이 있습니다.
문제 해결
흔히 발생하는 문제와 해결 방법은 다음과 같습니다.
- 속도 제한 초과 : 구성 섹션에 설명된 대로 GitHub 토큰을 설정하세요.
- 명령을 찾을 수 없습니다 : 패키지가 전역적으로 설치되었는지 확인하세요.
- 연결 오류 : 인터넷 연결 및 GitHub API 상태를 확인하세요
문제가 발생하면 오류 메시지 출력을 확인하거나 GitHub 저장소에 문제를 생성하세요.
즐겨보세요! ☺️
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
GitHub Repo MCP는 AI 비서가 GitHub 저장소를 탐색하고, 디렉토리를 탐색하고, 파일 내용을 볼 수 있게 해주는 오픈 소스 MCP 서버입니다.