Repo Radar MCP

Descubre, clasifica y compara repositorios de GitHub desde cualquier cliente de IA compatible con MCP.

Repo Radar MCP es un servidor MCP basado en Python que conecta agentes de IA a la API de GitHub, permitiéndoles buscar, filtrar, clasificar y evaluar repositorios de código abierto por tema, lenguaje, estrellas, licencia, actividad y relevancia.

Está diseñado para desarrolladores, creadores y agentes de IA que necesitan una forma estructurada de investigar proyectos de código abierto.

¿Por qué Repo Radar MCP?

Los agentes de IA pueden escribir código, pero también necesitan un buen contexto técnico.

Repo Radar MCP proporciona a tu cliente compatible con MCP un conjunto sencillo de herramientas para responder preguntas como:

• ¿Cuáles son los repositorios de Python más populares sobre RAG?

• ¿Qué servidores MCP vale la pena estudiar?

• ¿Qué proyectos de GitHub están activos, tienen licencia y son útiles?

• ¿Qué repositorio debería usar como referencia para mi próximo proyecto?

• ¿Cómo se comparan varios repositorios por estrellas, forks, issues, licencia y actividad reciente?

Related MCP server: Narad GitHub Agent

Características

• Buscar repositorios de GitHub por tema.

• Filtrar por lenguaje de programación.

• Filtrar por número mínimo de estrellas.

• Clasificar repositorios con una puntuación de utilidad sencilla.

• Analizar un solo repositorio.

• Comparar varios repositorios.

• Obtener el contenido del README de un repositorio.

• Devolver resultados en formato JSON o Markdown.

• Utiliza tu token de GitHub de forma segura desde variables de entorno.

• Funciona con MCP Inspector, Claude Desktop, Cursor y otros clientes compatibles con MCP.

Herramientas MCP

Instalación

Clona el repositorio:

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

Crea y activa un entorno virtual.

Windows PowerShell

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

macOS / Linux

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

Instala el proyecto:

pip install -e .

Copia el archivo de entorno:

cp .env.example .env

En Windows PowerShell:

copy .env.example .env

Edita .env y añade tu token de GitHub:

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

Nunca subas tu archivo .env real al repositorio.

Ejecutar con MCP Inspector

Desde la raíz del proyecto:

mcp dev server.py

Si el Inspector no encuentra uv, utiliza esta configuración en el Inspector:

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

Luego abre la pestaña Tools y ejecuta:

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

Ejemplo para Claude Desktop

Hay una configuración de muestra disponible en:

examples/claude_desktop_config.example.json

Ejemplo de entrada para 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"
      ]
    }
  }
}

Ejemplos de Prompts

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.

Hay más prompts disponibles en:

examples/prompts.md

Puntuación del Repositorio

Repo Radar MCP incluye un sistema de puntuación sencillo basado en:

• Estrellas

• Forks

• Actividad reciente

• Disponibilidad de licencia

• Issues abiertos

• Estado de archivado

La puntuación no pretende reemplazar el juicio humano. Es una señal rápida para ayudar a los agentes y desarrolladores a priorizar qué inspeccionar primero.

Estructura del Proyecto

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

Hoja de Ruta

• Añadir análisis de lanzamientos (releases) del repositorio.

• Añadir análisis de calidad de los issues.

• Añadir métricas de actividad de los colaboradores.

• Añadir soporte para recomendaciones de temas de GitHub.

• Añadir informe de salud del repositorio.

• Añadir asistentes de exportación a CSV y JSON.

• Añadir soporte para Docker.

• Añadir GitHub Actions para pruebas y linting.

Seguridad

Repo Radar MCP utiliza un token de GitHub desde variables de entorno.

No subas al repositorio:

• .env

• Tokens de acceso personal

• Claves de API privadas

• Entornos virtuales locales

El archivo .gitignore ya excluye archivos sensibles y generados comunes.

Contribuciones

Las contribuciones son bienvenidas.

Buenas primeras tareas (good first issues):

• Mejorar la lógica de puntuación.

• Añadir más formatos de salida.

• Añadir pruebas.

• Mejorar los ejemplos de clientes MCP.

• Añadir soporte para Docker.

Licencia

Este proyecto está bajo la Licencia MIT.

Creado por Javier Morrón. Conecta conmigo en LinkedIn: https://www.linkedin.com/in/javiermorron.