🔍 Repo Scout MCP Server

"La regla #1 para Vibe Coders e Ingenieros de Software: No reinventes la rueda. ¡Deja que la IA explore proyectos existentes en GitHub antes de escribir una sola línea de código!"

Un servidor local gratuito y de alto rendimiento del Model Context Protocol (MCP) que permite a los asistentes de IA (Google Antigravity, Claude Desktop, Cursor, Claude Code) buscar en GitHub proyectos, librerías y frameworks de código abierto existentes antes de que empieces a construir desde cero.

👤 Autor y Créditos

• Autor: Akash Kumar Jha

• Licencia: MIT License (Gratis y de Código Abierto)

Related MCP server: GitBridge

🚀 ¿Por Qué Usar Repo Scout MCP?

Al hacer vibe coding o construir software, los desarrolladores suelen pasar horas escribiendo código para funciones o aplicaciones completas que ya existen como proyectos de código abierto probados en batalla y de alta calidad.

Repo Scout MCP conecta tu asistente de codificación con IA directamente a las APIs de búsqueda e inteligencia de GitHub:

• 💡 Ahorra Cientos de Horas: Descubre al instante soluciones existentes antes de empezar un proyecto.

• 🆓 100% Gratis y Local: No requiere suscripciones de pago a APIs. Se ejecuta localmente mediante Node.js sobre stdio.

• ⚡ Alto Rendimiento: Aumenta el límite de peticiones de GitHub de 60 a 5,000 peticiones/hora con un token gratuito.

• 🛡️ Privacidad y Seguridad: Cero claves hardcodeadas o rastreo. Cada usuario proporciona sus propias variables de entorno.

🛠️ Herramientas Incluidas

📦 Inicio Rápido e Instalación

Paso 1: Clona el Repositorio

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

Paso 2: Obtén un Token de Acceso Gratuito de GitHub (2 Minutos)

1. Ve a GitHub Settings -> Tokens.

2. Haz clic en Generate new token $\rightarrow$ Generate new token (classic).

3. Nómbralo repo-scout-mcp.

4. Deja todas las casillas de permisos sin marcar (la búsqueda de datos públicos no requiere permisos).

5. Haz clic en Generate token y cópialo (tiene este formato: ghp_xxxxxxxxxxxx).

🔌 Conectando a tu Asistente de IA

1. Google Antigravity

1. Abre Antigravity $\rightarrow$ haz clic en el menú ... en la parte superior derecha del panel del agente.

2. Ve a MCP Servers $\rightarrow$ Manage MCP Servers $\rightarrow$ View raw config (mcp_config.json).

3. Añade la siguiente entrada dentro de "mcpServers":

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

(Nota: Reemplaza G:\\CODE\\repo-scout-mcp\\index.js con tu ruta de archivo completa real, usando dobles barras invertidas en Windows).

4. Guarda mcp_config.json y actualiza los servidores MCP (o escribe /mcp en el chat).

2. Claude Desktop

Añade a tu 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

Ejecuta:

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

💬 Ejemplos de Prompts para Probar

Una vez conectado, simplemente dale instrucciones a tu asistente de IA:

• Antes de empezar un proyecto:

  "Estoy planeando crear un panel de control autoalojado para monitorizar contenedores Docker. Usa repo-scout para comprobar si ya existe un gran proyecto de código abierto."

• Buscando librerías:

  "Usa repo-scout para buscar paquetes de indicadores técnicos financieros en TypeScript con muchas estrellas."

• Evaluando un repositorio:

  "Usa repo-scout get_repo_details en shadcn/ui para resumir su estructura."

📄 Licencia

Creado por Akash Kumar Jha. Publicado bajo la MIT License.