Skip to main content
Glama
repo-scout
by Akash1070

🔍 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: oss-trends-mcp

🚀 ¿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

Nombre de la Herramienta

Descripción

Ejemplo de Uso

suggest_stack

Proporciona una descripción en lenguaje natural de lo que quieres construir. Ejecuta búsquedas en GitHub desde múltiples ángulos (incluyendo awesome-lists) y devuelve una lista corta clasificada de repos para reutilizar.

"Estoy creando una app de notas markdown con etiquetas. Comprueba si ya existe algo."

search_repos

Búsqueda por palabra clave, tema e idioma en GitHub ordenada por estrellas, forks o actualidad.

"Encuentra middleware de limitación de peticiones para Node.js ordenado por estrellas."

get_repo_details

Obtiene el README completo y la estructura de archivos de nivel superior de un repositorio para que la IA pueda evaluar la adecuación del código.

"Comprueba los detalles de facebook/react."


📦 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).

  1. 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.

Available Tools

3 tools
get_repo_detailsA

Fetch details for one specific repo (owner/name), including README excerpt and top-level file list, so you can judge whether it fits your use case.

Inputs: repo (required).

search_reposB

Search public GitHub repositories by keyword/topic. Returns stars, last-updated, license, etc.

Inputs: query (required), sort, limit, language, +1 more.

suggest_stackA

Given a plain-language description of what you're about to build, runs several targeted GitHub searches (including curated/awesome-list style queries) and returns a ranked shortlist of existing projects/libraries you could reuse instead of building from scratch.

Inputs: description (required), language, limit_per_query.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: retrieving details for a specific known repo, searching by keywords, and generating a shortlist from a natural-language description. No overlap in functionality or target resource.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case: get_repo_details, search_repos, suggest_stack. This is a predictable and uniform convention.

    Tool Count5/5

    With only 3 tools, the server is tightly scoped to the 'repo scout' purpose: discovery (search), semantic suggestion (suggest), and evaluation (get details). Each tool earns its place, and the count is within the ideal 3-15 range.

    Completeness5/5

    The tool surface covers the full workflow for scouting repositories: finding candidates (search_repos, suggest_stack) and inspecting them (get_repo_details). No obvious gaps or dead ends for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to prospect across GitHub, PyPI, and npm, searching repositories, packages, and code patterns with read-only tools.
      7
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI builders to discover trending open-source projects for a given task by ranking repos based on GitHub momentum, npm/PyPI growth, and Hacker News buzz, with tools to recommend, search, assess health, and compare repositories.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding agents to discover, evaluate, and select the best existing open-source implementations by assessing license compatibility, extracting only the needed symbols and dependencies, and producing integration or adaptation plans.
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to analyze public GitHub repositories directly through tools for repo health scoring, recent commit summaries, good first issue discovery, and semantic Q&A over docs and issues.
      4
      31 npm
      1
      MIT