🔍 Repo Scout MCP 서버

"바이브 코딩(Vibe Coding)과 소프트웨어 엔지니어를 위한 제1원칙: 바퀴를 다시 발명하지 마세요. 코드 한 줄을 작성하기 전에 AI가 기존 GitHub 프로젝트를 먼저 탐색하게 하세요!"

AI 어시스턴트(Google Antigravity, Claude Desktop, Cursor, Claude Code)가 처음부터 빌드를 시작하기 전에 GitHub에서 기존 오픈소스 프로젝트, 라이브러리, 프레임워크를 검색할 수 있게 해주는 고성능 무료 로컬 Model Context Protocol (MCP) 서버입니다.

👤 작성자 및 크레딧

• 작성자: Akash Kumar Jha

• 라이선스: MIT License (무료 및 오픈소스)

Related MCP server: GitBridge

🚀 Repo Scout MCP를 사용해야 하는 이유는?

바이브 코딩을 하거나 소프트웨어를 빌드할 때, 개발자들은 이미 검증되고 고품질의 오픈소스 프로젝트로 존재하는 기능이나 완전한 애플리케이션을 위해 수많은 시간을 코드 작성에 허비하곤 합니다.

Repo Scout MCP는 AI 코딩 어시스턴트를 GitHub의 검색 및 인텔리전스 API에 직접 연결합니다:

• 💡 수백 시간 절약: 프로젝트를 시작하기 전에 기존 솔루션을 즉시 발견하세요.

• 🆓 100% 무료 및 로컬: 유료 API 구독이 필요 없습니다. Node.js를 통해 stdio로 로컬에서 실행됩니다.

• ⚡ 고성능: 무료 토큰으로 GitHub 속도 제한을 60에서 시간당 5,000건의 요청으로 높입니다.

• 🛡️ 프라이버시 및 보안: 하드코딩된 키나 추적이 전혀 없습니다. 각 사용자가 자신의 환경 변수를 제공합니다.

🛠️ 포함된 도구

📦 빠른 시작 및 설치

1단계: 저장소 클론

git clone https://github.com/YOUR_USERNAME/repo-scout-mcp.git
cd repo-scout-mcp
npm install

2단계: 무료 GitHub 액세스 토큰 받기 (2분)

1. GitHub 설정 -> 토큰으로 이동합니다.

2. 새 토큰 생성 $\rightarrow$ 새 토큰 생성(클래식) 을 클릭합니다.

3. 이름을 repo-scout-mcp로 지정합니다.

4. 모든 범위 확인란을 선택 해제합니다 (공개 데이터 검색에는 권한이 필요하지 않습니다).

5. 토큰 생성을 클릭하고 복사합니다 (ghp_xxxxxxxxxxxx 형태).

🔌 AI 어시스턴트에 연결하기

1. Google Antigravity

1. Antigravity를 열고 에이전트 패널 오른쪽 상단의 ... 메뉴를 클릭합니다.

2. MCP 서버 $\rightarrow$ MCP 서버 관리 $\rightarrow$ 원시 구성 보기(mcp_config.json)로 이동합니다.

3. "mcpServers" 안에 다음 항목을 추가합니다:

{
  "mcpServers": {
    "repo-scout": {
      "command": "node",
      "args": ["G:\\CODE\\repo-scout-mcp\\index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here"
      }
    }
  }
}

(참고: G:\\CODE\\repo-scout-mcp\\index.js를 실제 전체 파일 경로로 바꾸고, Windows에서는 이중 백슬래시를 사용하세요).

4. mcp_config.json을 저장하고 MCP 서버를 새로고침합니다 (또는 채팅에서 /mcp를 입력).

2. Claude Desktop

claude_desktop_config.json에 추가합니다:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "repo-scout": {
      "command": "node",
      "args": ["/absolute/path/to/repo-scout-mcp/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here"
      }
    }
  }
}

3. Claude Code CLI

실행:

claude mcp add repo-scout node /absolute/path/to/repo-scout-mcp/index.js -e GITHUB_TOKEN=ghp_your_token_here

💬 사용해 볼 예시 프롬프트

연결이 완료되면 AI 어시스턴트에게 간단히 프롬프트를 입력하세요:

• 프로젝트를 시작하기 전에:

  "Docker 컨테이너 모니터링용 자체 호스팅 대시보드를 구축하려고 합니다. repo-scout를 사용하여 훌륭한 오픈소스 프로젝트가 이미 존재하는지 확인해 주세요."

• 라이브러리 검색:

  "repo-scout를 사용하여 별점이 높은 TypeScript 금융 기술 지표 패키지를 검색해 주세요."

• 저장소 평가:

  "repo-scout get_repo_details를 shadcn/ui에 사용하여 그 구조를 요약해 주세요."

📄 라이선스

Akash Kumar Jha가 제작했습니다. MIT License에 따라 배포됩니다.