Repolode
Enviar
Role1776

Role1776/mcp-retrieval

Servidor MCP en Go que ofrece a clientes LLM búsqueda web e imágenes, y extracción de páginas a Markdown, sin necesidad de claves API.

Ver en GitHubSitio web
Estrellas
23
Forks
2
Issues abiertos
0
Último commit
hace 14 días

¿Qué es?

mcp-retrieval es un servidor Model Context Protocol escrito en Go. Expone tres herramientas de solo lectura a clientes compatibles con MCP, como Claude Desktop o agentes de IDE: web_search para búsquedas web, web_search_images para búsquedas de imágenes y web_scrape para extraer el texto principal de un artículo y devolverlo como Markdown.

La búsqueda web usa DuckDuckGo Lite, la búsqueda de imágenes usa Bing Images y la obtención de páginas procesa el HTML con un extractor de legibilidad, por lo que no se necesitan claves API de motores de búsqueda. Las solicitudes imitan navegadores reales en la capa TLS mediante perfiles de navegador rotativos. También se puede configurar un proxy rotativo opcional para que cada solicitud use una nueva IP de salida.

El servidor funciona con stdio de forma predeterminada o como servidor HTTP con streaming. Cada llamada distribuye en paralelo las consultas o URL de la lista y devuelve un estado por elemento: success, failed o timeout. Además, aplica límites configurables a la cantidad de elementos, los tiempos de espera y la longitud de las entradas.

Funciones clave

  • 01Tres herramientas de solo lectura: búsqueda web, búsqueda de imágenes y extracción de páginas.
  • 02La búsqueda y el contenido de las páginas funcionan sin claves API de motores de búsqueda.
  • 03El contenido de las páginas se extrae con un analizador de legibilidad y se devuelve como Markdown.
  • 04Suplantación de la huella TLS de navegadores y compatibilidad opcional con proxy rotativo.
  • 05Admite los transportes stdio y HTTP con streaming.
  • 06Informes de estado por elemento, para que los fallos parciales no impidan devolver los resultados correctos.

Casos de uso

  • Proporcionar resultados de búsqueda web en tiempo real a un asistente LLM local sin pagar por una API de búsqueda.
  • Introducir el texto de artículos de páginas web en un modelo como Markdown limpio.
  • Permitir que un agente de IDE consulte documentación o información actualizada durante la programación.
  • Ejecutar un servidor de recuperación compartido por un equipo a través de HTTP.

Inicio rápido

  1. 1

    Compila el binario desde el código fuente (requiere Go 1.25.5 o posterior).

    make build
  2. 2

    Ejecuta el servidor con el transporte stdio predeterminado.

    ./bin/mcp-retrieval

Antes de usarlo

  • web_scrape solo procesa HTML, por lo que no devuelve nada para texto sin formato ni URL de archivos, como raw.githubusercontent.com.
  • La relevancia de los resultados de búsqueda de imágenes no está garantizada; pueden no guardar relación y es necesario revisarlos.
  • Las páginas se obtienen sin ejecutar JavaScript, así que no se extrae el contenido renderizado en el cliente.
  • Las ráfagas de búsquedas en paralelo pueden activar el desafío antibots de DuckDuckGo y provocar fallos hasta que baje la frecuencia de las solicitudes; se necesita un proxy para repartir la carga.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCPGeneradores de sitios estáticos y herramientas de documentación

Temas

#mcp#web-search#web-scraping#llm-tools#markdown#golang#image-search#ai-agents#bing-images#duckduckgo

Preguntas frecuentes

¿Qué es mcp-retrieval?
Servidor MCP en Go que ofrece a clientes LLM búsqueda web e imágenes, y extracción de páginas a Markdown, sin necesidad de claves API. mcp-retrieval es un servidor Model Context Protocol escrito en Go. Expone tres herramientas de solo lectura a clientes compatibles con MCP, como Claude Desktop o agentes de IDE: web_search para búsquedas web, web_search_images para búsquedas de imágenes y web_scrape para extraer el texto principal de un artículo y devolverlo como Markdown.
¿mcp-retrieval es gratuito? ¿Qué licencia tiene?
mcp-retrieval es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-retrieval sigue mantenido?
Mantenimiento activo. El último commit de mcp-retrieval fue el 24 oct 2026.
¿Para qué puedo usar mcp-retrieval?
Proporcionar resultados de búsqueda web en tiempo real a un asistente LLM local sin pagar por una API de búsqueda. Introducir el texto de artículos de páginas web en un modelo como Markdown limpio. Permitir que un agente de IDE consulte documentación o información actualizada durante la programación. Ejecutar un servidor de recuperación compartido por un equipo a través de HTTP.
¿Cómo se instala mcp-retrieval?
Compila el binario desde el código fuente (requiere Go 1.25.5 o posterior).: make build Ejecuta el servidor con el transporte stdio predeterminado.: ./bin/mcp-retrieval
¿Dónde consigo mcp-retrieval?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Role1776/mcp-retrieval

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados