MCP activo

Servidor MCP de awesome-repositories.com.

Apunta cualquier agente compatible con MCP a https://awesome-repositories.com/api/mcp. La primera llamada a la herramienta te guiará a través de un inicio de sesión con Google en un solo clic; después, tu agente podrá buscar en el directorio por intención, leer cualquier repositorio y encontrar su documentación. Es un servidor de solo lectura: busca y lee, no escribe nada.

Conecta el servidor: un comando, todos los agentes

Añade el servidor a cada cliente MCP que detecte: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Zed, Goose, Copilot CLI y más. Añade -y para omitir las solicitudes, -g para una instalación global (a nivel de usuario), o --agent <client> para apuntar a uno.

npx add-mcp https://awesome-repositories.com/api/mcp --name awesome-repositories

O añádelo por cliente

Claude Code

claude mcp add --transport http awesome-repositories https://awesome-repositories.com/api/mcp

VS Code

code --add-mcp '{"name":"awesome-repositories","type":"http","url":"https://awesome-repositories.com/api/mcp"}'

Cursor / Codex / Windsurf / Zed

npx add-mcp https://awesome-repositories.com/api/mcp --agent cursor   # or: codex · windsurf · zed · cline · goose

Claude Desktop / cualquier otro cliente: pégalo en su configuración de MCP

{
  "mcpServers": {
    "awesome-repositories": {
      "type": "http",
      "url": "https://awesome-repositories.com/api/mcp"
    }
  }
}

Sin cabecera Authorization: el cliente gestiona el proceso OAuth por ti.

Opcional: instalar la skill de búsqueda

Instala una skill (cómo resolver la intención hacia rutas de etiquetas y realizar búsquedas eficaces) en cada agente que tengas, a través del índice conocido en /.well-known/agent-skills/index.json. La skill enseña al agente a manejar las herramientas; la conexión anterior es lo que realmente vincula el servidor.

npx skills add https://awesome-repositories.com

Autenticación

OAuth 2.1: no hay token que pegar. El cliente descubre automáticamente el servidor de autorización desde /.well-known/oauth-protected-resource, se registra a sí mismo (Dynamic Client Registration) y luego abre una pestaña del navegador para que puedas iniciar sesión con Google. Los tokens de refresco mantienen la sesión activa. Cada usuario autenticado puede llamar a cualquier herramienta; este es un servidor de solo lectura, por lo que no hay nada que restringir por roles.

Herramientas

Todas de solo lectura. Disponibles para cualquier usuario autenticado.

search_repositories — búsqueda híbrida BM25 + IA. El re-ranking por IA está activado por defecto (vuelve a BM25 cuando se agota la cuota diaria); usa ai:false para BM25 puro. Acota con filter_tag_paths.
search_metadata_tags — búsqueda híbrida sobre el árbol de etiquetas unificado: resuelve un concepto a una ruta de etiqueta canónica antes de filtrar una búsqueda.
get_repository — detalle completo de un repositorio por ID interno o owner/repo, con asignaciones de etiquetas y conteo de documentos.
list_curated_searches — slugs de búsqueda fijados por administradores: puntos de partida útiles para el descubrimiento.
list_repository_docs — las páginas de documentación indexadas para un repositorio (readme / doc), cada una con su URL de origen: obtén el cuerpo de una página directamente desde esa URL.