Repolode
Enviar
Role1776

Role1776/mcp-retrieval

Servidor MCP em Go que oferece a clientes LLM busca na web, busca de imagens e extração de páginas em Markdown, sem exigir chaves de API.

Ver no GitHubSite
Estrelas
23
Forks
2
Issues abertas
0
Último commit
há 13 dias

O que é?

mcp-retrieval é um servidor Model Context Protocol escrito em Go. Ele disponibiliza três ferramentas somente de leitura para clientes compatíveis com MCP, como Claude Desktop ou agentes de IDE: web_search para consultas na web, web_search_images para buscas de imagens e web_scrape para extrair o texto principal de uma página em Markdown.

A busca na web usa DuckDuckGo Lite, a busca de imagens usa Bing Images e a obtenção de páginas processa o HTML com um extrator de legibilidade, sem exigir chaves de API de mecanismos de busca. As requisições se passam por navegadores reais no nível TLS, usando perfis de navegador rotativos; também é possível configurar um proxy rotativo opcional para que cada requisição use um novo IP de saída.

Por padrão, o servidor funciona via stdio, mas também pode operar como servidor HTTP streamable. Cada chamada distribui o trabalho em paralelo pelas consultas ou URLs da lista e retorna um status por item: sucesso, falha ou timeout. Também aplica limites configuráveis para quantidade de itens, timeouts e tamanho da entrada.

Recursos principais

  • 01Três ferramentas somente de leitura: busca na web, busca de imagens e extração de páginas.
  • 02Busca e conteúdo de páginas funcionam sem chaves de API de mecanismos de busca.
  • 03O conteúdo das páginas é extraído com um parser de legibilidade e retornado em Markdown.
  • 04Imitação de fingerprint TLS de navegadores e suporte opcional a proxy rotativo.
  • 05Suporte aos transportes stdio e HTTP streamable.
  • 06Relatório de status por item, permitindo retornar os resultados bem-sucedidos mesmo quando há falhas parciais.

Casos de uso

  • Oferecer resultados de busca na web em tempo real a um assistente LLM local sem pagar por uma API de busca.
  • Fornecer a um modelo o texto de artigos de páginas da web em Markdown limpo.
  • Permitir que um agente de IDE consulte documentação ou informações atualizadas durante a programação.
  • Executar um servidor de retrieval compartilhado por uma equipe via HTTP.

Início rápido

  1. 1

    Compile o binário a partir do código-fonte (requer Go 1.25.5 ou superior).

    make build
  2. 2

    Execute o servidor usando o transporte stdio padrão.

    ./bin/mcp-retrieval

Antes de usar

  • web_scrape processa apenas HTML, então não retorna nada para texto simples nem URLs de arquivos, como raw.githubusercontent.com.
  • A relevância dos resultados da busca de imagens não é garantida; eles podem não ter relação e precisam ser verificados.
  • As páginas são obtidas sem executar JavaScript, portanto o conteúdo renderizado no cliente não é extraído.
  • Picos de buscas paralelas podem acionar o desafio antibot do DuckDuckGo e causar falhas até a frequência das solicitações diminuir; é necessário usar um proxy para distribuir a carga.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPGeradores de sites estáticos e ferramentas de documentação

Tópicos

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

Perguntas frequentes

O que é mcp-retrieval?
Servidor MCP em Go que oferece a clientes LLM busca na web, busca de imagens e extração de páginas em Markdown, sem exigir chaves de API. mcp-retrieval é um servidor Model Context Protocol escrito em Go. Ele disponibiliza três ferramentas somente de leitura para clientes compatíveis com MCP, como Claude Desktop ou agentes de IDE: web_search para consultas na web, web_search_images para buscas de imagens e web_scrape para extrair o texto principal de uma página em Markdown.
mcp-retrieval é gratuito? Qual é a licença?
mcp-retrieval é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-retrieval ainda é mantido?
Manutenção ativa. O último commit de mcp-retrieval foi em 24 de out. de 2026.
Para que posso usar mcp-retrieval?
Oferecer resultados de busca na web em tempo real a um assistente LLM local sem pagar por uma API de busca. Fornecer a um modelo o texto de artigos de páginas da web em Markdown limpo. Permitir que um agente de IDE consulte documentação ou informações atualizadas durante a programação. Executar um servidor de retrieval compartilhado por uma equipe via HTTP.
Como instalar mcp-retrieval?
Compile o binário a partir do código-fonte (requer Go 1.25.5 ou superior).: make build Execute o servidor usando o transporte stdio padrão.: ./bin/mcp-retrieval
Onde consigo mcp-retrieval?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Role1776/mcp-retrieval

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados