Repo Radar MCP

Находите, ранжируйте и сравнивайте репозитории GitHub из любого MCP-совместимого ИИ-клиента.

Repo Radar MCP — это MCP-сервер на базе Python, который подключает ИИ-агентов к API GitHub, позволяя им искать, фильтровать, ранжировать и оценивать репозитории с открытым исходным кодом по теме, языку, звездам, лицензии, активности и релевантности.

Он разработан для разработчиков, создателей и ИИ-агентов, которым нужен структурированный способ исследования проектов с открытым исходным кодом.

Зачем нужен Repo Radar MCP?

ИИ-агенты могут писать код, но им также нужен хороший технический контекст.

Repo Radar MCP предоставляет вашему MCP-совместимому клиенту простой набор инструментов для ответов на такие вопросы, как:

• Какие Python-репозитории по теме RAG наиболее популярны?

• Какие MCP-серверы стоит изучить?

• Какие проекты на GitHub активны, имеют лицензию и полезны?

• Какой репозиторий мне использовать в качестве примера для моего следующего проекта?

• Как сравнить несколько репозиториев по количеству звезд, форков, проблем (issues), лицензии и недавней активности?

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 включает простую систему оценки, основанную на:

• Звездах

• Форках

• Недавней активности

• Наличии лицензии

• Открытых проблемах (issues)

• Статусе архивации

Оценка не предназначена для замены человеческого суждения. Это быстрый сигнал, помогающий агентам и разработчикам определить приоритеты для первоочередного изучения.

Структура проекта

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

Дорожная карта

• Добавить анализ релизов репозитория.

• Добавить анализ качества проблем (issues).

• Добавить метрики активности участников.

• Добавить поддержку рекомендаций по темам GitHub.

• Добавить отчет о состоянии репозитория.

• Добавить помощники для экспорта в CSV и JSON.

• Добавить поддержку Docker.

• Добавить GitHub Actions для тестирования и линтинга.

Безопасность

Repo Radar MCP использует токен GitHub из переменных окружения.

Не добавляйте в систему контроля версий:

• .env

• Персональные токены доступа

• Приватные ключи API

• Локальные виртуальные окружения

Файл .gitignore уже исключает распространенные конфиденциальные и сгенерированные файлы.

Вклад в проект

Вклад приветствуется.

Хорошие задачи для начала:

• Улучшить логику оценки.

• Добавить больше форматов вывода.

• Добавить тесты.

• Улучшить примеры MCP-клиентов.

• Добавить поддержку Docker.

Лицензия

Этот проект лицензирован по лицензии MIT.

Создано Хавьером Морроном. Свяжитесь со мной в LinkedIn: https://www.linkedin.com/in/javiermorron.