GitHub Repo MCP는 AI 조수가 GitHub 저장소를 검색하고 감독을 탐구하고 파일 내용을 볼 수있는 오픈 소스 MCP 서버입니다.

내용 표

시작하기 • 기능 개요

✨ 주요 특징

• Cursor, Windsurf, Claude Desktop 및 기타 MCP 클라이언트와 호환 가능 stdio 프로토콜
• GitHub 저장소의 내용을 검색
• 저장소 디렉토리 및 하위 디렉토리를 통해 Navigate
• 코드 및 텍스트 파일의 내용보기
• 패키지 관리자를 통해 쉬운 설치

시작하기

# 필수품

서버를 설치하면 시스템에 다음을 요구합니다.

• 노드.js 18+
• npm 또는 원사

단계 1. 임명

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

맥 OS

윈도우 NPX

.cursor/mcp.json를 통해 Windows NPX

.cursor/mcp.json을 통해 Windows NPX (설정되지 않는 경로)

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 GitHub Repo MCP 설치하기:

몇 초를 기다립니다 또는 새로 고침 버튼을 몇 번 등록하지 않는 경우. 아직 등록하지 않은 경우, 올바른 명령을 입력해야합니다.

GitHub Repo MCP

GitHub Repo MCP is an open-source MCP server that lets your AI assistants browse GitHub repositories, explore directories, and view file contents.

Table of contents

Getting started • Feature overview

✨ Key features

• 💻 Compatible with Cursor, Windsurf, Claude Desktop, and other MCP clients supporting stdio protocol
• 🔎 Browse the contents of any public GitHub repository
• 📂 Navigate through repository directories and subdirectories
• 📝 View the content of code and text files
• 📦 Easy installation via package manager

Getting Started

Prerequisites

Installing the server requires the following on your system:

• Node.js 18+
• npm or yarn

Step 1. Installation

You can install and run GitHub Repo MCP using Smithery, NPX, or setting in mcp.json of your IDE:

MacOS

npx github-repo-mcp

Windows NPX

cmd /c npx -y github-repo-mcp

Windows NPX via .cursor/mcp.json

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

Windows NPX via .cursor/mcp.json (if path not set)

# 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
    }
  }
}

Installing via Smithery

To install GitHub Repo MCP for Claude Desktop automatically via Smithery:

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

Wait a few seconds or click on the refresh button a few times if it does not register. If it still won’t register, make sure you entered the right command.

Step 2. Configuration

The GitHub Repo MCP server can use a GitHub token for higher rate limits when accessing the GitHub API.

Environment Variables

Setting Up a GitHub Token (Optional)