repo-scout
🔍 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: Implementation Intelligence 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 |
| 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." |
| 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." |
| 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 |
📦 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 installPaso 2: Obtén un Token de Acceso Gratuito de GitHub (2 Minutos)
Haz clic en Generate new token $\rightarrow$ Generate new token (classic).
Nómbralo
repo-scout-mcp.Deja todas las casillas de permisos sin marcar (la búsqueda de datos públicos no requiere permisos).
Haz clic en Generate token y cópialo (tiene este formato:
ghp_xxxxxxxxxxxx).
🔌 Conectando a tu Asistente de IA
1. Google Antigravity
Abre Antigravity $\rightarrow$ haz clic en el menú
...en la parte superior derecha del panel del agente.Ve a MCP Servers $\rightarrow$ Manage MCP Servers $\rightarrow$ View raw config (
mcp_config.json).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).
Guarda
mcp_config.jsony actualiza los servidores MCP (o escribe/mcpen el chat).
2. Claude Desktop
Añade a tu claude_desktop_config.json:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/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/uipara resumir su estructura."
📄 Licencia
Creado por Akash Kumar Jha. Publicado bajo la MIT License.
Available Tools
3 toolsget_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
Scored across 3 tools
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.
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.
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.
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.
Maintenance
Related MCP Connectors
Finds real, maintained open-source repos that fit your project. MCP grounding for coding agents.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Search agent-ready open source repos by task, interface, ecosystem and OG score.
GitHub repo search, stats, language breakdown and comparison as agent tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to prospect across GitHub, PyPI, and npm, searching repositories, packages, and code patterns with read-only tools.780 PyPI5MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables 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.431 npm1MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to search, inspect, compare, and evaluate GitHub repositories using read-only tools, including topic discovery, repository health scoring, security advisories, dependency audits, and supply-chain risk checks. It returns concise, readable results and can work without a token, with optional authentication for higher rate limits and code search.1662 npmMIT