Repo Radar MCP

모든 MCP 호환 AI 클라이언트에서 GitHub 저장소를 검색, 순위 지정 및 비교하세요.

Repo Radar MCP는 AI 에이전트를 GitHub API에 연결하는 Python 기반 MCP 서버로, 주제, 언어, 별점, 라이선스, 활동 및 관련성을 기준으로 오픈 소스 저장소를 검색, 필터링, 순위 지정 및 평가할 수 있게 해줍니다.

이 도구는 오픈 소스 프로젝트를 체계적으로 조사해야 하는 개발자, 빌더 및 AI 에이전트를 위해 설계되었습니다.

왜 Repo Radar MCP인가요?

AI 에이전트는 코드를 작성할 수 있지만, 좋은 기술적 맥락도 필요합니다.

Repo Radar MCP는 MCP 호환 클라이언트에 다음과 같은 질문에 답할 수 있는 간단한 도구 세트를 제공합니다:

• RAG에 관한 가장 인기 있는 Python 저장소는 무엇인가요?

• 공부할 가치가 있는 MCP 서버는 무엇인가요?

• 활동 중이고 라이선스가 있으며 유용한 GitHub 프로젝트는 무엇인가요?

• 다음 프로젝트의 참조로 어떤 저장소를 사용해야 할까요?

• 여러 저장소를 별점, 포크, 이슈, 라이선스 및 최근 활동별로 어떻게 비교할 수 있을까요?

Related MCP server: Narad GitHub Agent

기능

• 주제별 GitHub 저장소 검색.

• 프로그래밍 언어별 필터링.

• 최소 별점별 필터링.

• 간단한 유용성 점수로 저장소 순위 지정.

• 단일 저장소 분석.

• 여러 저장소 비교.

• 저장소 README 콘텐츠 가져오기.

• JSON 또는 Markdown으로 결과 반환.

• 환경 변수에서 GitHub 토큰을 안전하게 사용.

• MCP Inspector, Claude Desktop, Cursor 및 기타 MCP 호환 클라이언트와 작동.

MCP 도구

설치

저장소를 복제합니다:

git clone https://github.com/javiermorron/repo-radar-mcp.git
cd repo-radar-mcp

가상 환경을 생성하고 활성화합니다.

Windows PowerShell

python -m venv .venv
.\.venv\Scripts\activate

macOS / Linux

python -m venv .venv
source .venv/bin/activate

프로젝트를 설치합니다:

pip install -e .

환경 파일을 복사합니다:

cp .env.example .env

Windows PowerShell에서:

copy .env.example .env

.env를 편집하고 GitHub 토큰을 추가합니다:

GITHUB_TOKEN=your_github_token_here
GITHUB_API_VERSION=2022-11-28
GITHUB_USER_AGENT=repo-radar-mcp/1.0.0

실제 .env 파일을 커밋하지 마십시오.

MCP Inspector로 실행

프로젝트 루트에서:

mcp dev server.py

Inspector가 uv를 찾지 못하면 Inspector에서 다음 구성을 사용하십시오:

Transport Type: STDIO
Command: python
Arguments: server.py

그런 다음 Tools 탭을 열고 다음을 실행합니다:

{
  "topic": "mcp server",
  "language": "Python",
  "limit": 5,
  "min_stars": 10
}

Claude Desktop 예시

샘플 구성은 다음에서 확인할 수 있습니다:

examples/claude_desktop_config.example.json

Windows 항목 예시:

{
  "mcpServers": {
    "repo-radar-mcp": {
      "command": "C:\\Users\\YOUR_USER\\repo-radar-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\YOUR_USER\\repo-radar-mcp\\server.py"
      ]
    }
  }
}

예시 프롬프트

Search the 5 most popular Python repositories about "mcp server" and explain which one is best to study.

Compare these repositories: freqtrade/freqtrade, ccxt/ccxt, hummingbot/hummingbot.

Find popular repositories about "rag chatbot" in Python with more than 500 stars and rank them by usefulness.

Analyze microsoft/autogen and tell me if it is active, useful and worth studying.

더 많은 프롬프트는 다음에서 확인할 수 있습니다:

examples/prompts.md

저장소 점수

Repo Radar MCP는 다음을 기반으로 하는 간단한 점수 시스템을 포함합니다:

• 별점

• 포크

• 최근 활동

• 라이선스 가용성

• 열린 이슈

• 보관 상태

이 점수는 인간의 판단을 대체하기 위한 것이 아닙니다. 에이전트와 개발자가 무엇을 먼저 조사할지 우선순위를 정하는 데 도움을 주는 빠른 신호입니다.

프로젝트 구조

repo-radar-mcp/
├── src/
│   └── repo_radar_mcp/
│       ├── __init__.py
│       ├── server.py
│       ├── github_client.py
│       ├── scoring.py
│       ├── formatters.py
│       └── models.py
├── examples/
│   ├── claude_desktop_config.example.json
│   └── prompts.md
├── tests/
│   └── test_scoring.py
├── .env.example
├── .gitignore
├── LICENSE
├── README.md
├── CHANGELOG.md
├── requirements.txt
├── pyproject.toml
└── server.py

로드맵

• 저장소 릴리스 분석 추가.

• 이슈 품질 분석 추가.

• 기여자 활동 지표 추가.

• GitHub 주제 추천 지원 추가.

• 저장소 상태 보고서 추가.

• CSV 및 JSON 내보내기 도우미 추가.

• Docker 지원 추가.

• 테스트 및 린팅을 위한 GitHub Actions 추가.

보안

Repo Radar MCP는 환경 변수의 GitHub 토큰을 사용합니다.

다음은 커밋하지 마십시오:

• .env

• 개인 액세스 토큰

• 비공개 API 키

• 로컬 가상 환경

.gitignore 파일은 이미 일반적인 민감한 파일과 생성된 파일을 제외하고 있습니다.

기여

기여를 환영합니다.

좋은 첫 번째 이슈:

• 점수 산정 로직 개선.

• 더 많은 출력 형식 추가.

• 테스트 추가.

• MCP 클라이언트 예시 개선.

• Docker 지원 추가.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.

Javier Morrón이 제작했습니다. LinkedIn에서 저와 연결하세요: https://www.linkedin.com/in/javiermorron.