GitHub 리포 MCP

👁 대장간 배지

목차

Related MCP server: GitHub DeepWiki MCP Server

✨ 주요 특징

• 💻 stdio 프로토콜을 지원하는 Cursor, Windsurf, Claude Desktop 및 기타 MCP 클라이언트와 호환됩니다.

• 🔎 모든 공개 GitHub 저장소의 콘텐츠를 탐색하세요

• 📂 저장소 디렉토리 및 하위 디렉토리 탐색

• 📝 코드 및 텍스트 파일의 내용 보기

• 📦 패키지 관리자를 통한 간편한 설치

시작하기

필수 조건

서버를 설치하려면 시스템에 다음이 필요합니다.

• 노드.js 18+

• npm 또는 yarn

1단계. 설치

Smithery, NPX를 사용하거나 IDE의 mcp.json을 설정하여 GitHub Repo MCP를 설치하고 실행할 수 있습니다.

맥OS

지엑스피1

윈도우 NPX

cmd /c npx -y github-repo-mcp

.cursor/mcp.json을 통한 Windows NPX

{
 "mcpServers": {
 "github-repo-mcp": {
 "command": "wsl",
 "args": [
 "bash",
 "-c",
 "cmd /c npx -y github-repo-mcp"
 ],
 "enabled": true
 }
 }
}

.cursor/mcp.json을 통한 Windows NPX(경로가 설정되지 않은 경우)

# Find the full path to npx first
which npx

{
 "mcpServers": {
 "github-repo-mcp": {
 "command": "wsl",
 "args": [
 "bash",
 "-c",
 "'/home/[username]/.nvm/versions/node/v20.18.0/bin/npx github-repo-mcp'"
 ],
 "enabled": true
 }
 }
}

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 GitHub Repo MCP를 자동으로 설치하려면:

npx -y @smithery/cli install @Ryan0204/github-repo-mcp --client claude

몇 초 정도 기다리거나, 등록되지 않으면 새로 고침 버튼을 몇 번 클릭하세요. 그래도 등록되지 않으면 명령어를 제대로 입력했는지 확인하세요.

2단계. 구성

GitHub Repo MCP 서버는 GitHub API에 액세스할 때 더 높은 속도 제한을 위해 GitHub 토큰을 사용할 수 있습니다.

환경 변수

GitHub 토큰 설정(선택 사항)

서버는 인증 없이 작동하지만, GitHub API는 인증되지 않은 요청에 대해 훨씬 낮은 속도 제한을 적용합니다. 속도 제한을 높이려면:

1. https://github.com/settings/tokens 에서 개인 액세스 토큰을 생성하세요.

2. mcp.json에서 토큰을 환경 변수로 설정합니다.

{
 "mcpServers": {
 "github-repo-mcp": {
 "command": "...",
 "args": [
 ...
 ],
 "env": {
 "GITHUB_TOKEN": "Your_Github_Token"
 }
 "enabled": true,
 }
 }
}

기능 개요

저장소 탐색 도구

이 서버는 GitHub 저장소와 상호 작용하기 위한 세 가지 주요 도구를 제공합니다.

1. getRepoAllDirectories

GitHub 저장소 루트에 있는 모든 파일과 디렉토리를 나열합니다.

• 매개변수 :

  • repoUrl : GitHub 저장소의 URL(예: " https://github.com/owner/repo ")

2. getRepoDirectories

GitHub 저장소의 특정 디렉토리의 내용을 나열합니다.

• 매개변수 :

  • repoUrl : GitHub 저장소의 URL

  • path : 가져올 디렉토리 경로(예: "src")

3. getRepoFile

GitHub 저장소에서 특정 파일의 내용을 검색하여 표시합니다.

• 매개변수 :

  • repoUrl : GitHub 저장소의 URL

  • path : 가져올 파일 경로(예: "src/index.js")

사용 예

다음은 AI 도우미와 함께 이러한 도구를 사용하는 방법에 대한 몇 가지 예입니다.

1. 저장소 루트 탐색 : AI 비서에게 " https://github.com/Ryan0204/github-repo-mcp 에 있는 저장소의 내용을 보여주세요"라고 요청하세요.

2. 특정 디렉토리 탐색 : " https://github.com/Ryan0204/github-repo-mcp 의 src 디렉토리에 어떤 파일이 있나요?"라고 질문해 보세요.

3. 파일 보기 : " https://github.com/Ryan0204/github-repo-mcp 에서 README.md 파일을 보여주세요"라고 요청합니다.

제한 사항

• 속도 제한 : 인증 없이 GitHub API는 엄격한 속도 제한(시간당 60개 요청)을 갖습니다.

• 개인 저장소 : 적절한 권한이 있는 토큰이 제공되지 않는 한 공개 저장소에만 액세스할 수 있습니다.

• 바이너리 파일 : 서버는 일반적인 바이너리 파일 확장자를 감지하고 해당 내용을 표시하지 않습니다.

• 대용량 파일 : GitHub API에는 검색할 수 있는 파일 크기에 제한이 있습니다.

문제 해결

흔히 발생하는 문제와 해결 방법은 다음과 같습니다.

• 속도 제한 초과 : 구성 섹션에 설명된 대로 GitHub 토큰을 설정하세요.

• 명령을 찾을 수 없습니다 : 패키지가 전역적으로 설치되었는지 확인하세요.

• 연결 오류 : 인터넷 연결 및 GitHub API 상태를 확인하세요

문제가 발생하면 오류 메시지 출력을 확인하거나 GitHub 저장소에 문제를 생성하세요.

즐겨보세요! ☺️

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• getRepoAllDirectoriesD
• getRepoDirectoriesD
• getRepoFileD