GitHub 리포 MCP

목차

Related MCP server: GitHub MCP Server Plus

✨ 주요 특징

• 💻 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 토큰 설정(선택 사항)

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

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

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

기능 개요

저장소 탐색 도구

이 서버는 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 저장소에 문제를 생성하세요.

즐겨보세요! ☺️