Servidor MCP SearXNG

Visão Geral

SearXNG MCP Server é um servidor Model Context Protocol (MCP) leve e de código aberto que conecta assistentes de IA (Claude, Cursor, LM Studio, LLMs locais, etc.) ao SearXNG — o popular motor de metabusca auto-hospedado que respeita a privacidade.

Ele permite que agentes realizem pesquisas na web sem depender de APIs comerciais como Google ou Bing, mantendo as consultas privadas e livres de rastreamento, perfis de usuário ou paywalls. Existem várias implementações da comunidade, sendo a mais popular a versão em Node.js mantida ativamente por ihor-sokoliuk.

Características Principais

• Busca com Foco em Privacidade: Agrega resultados de dezenas de motores de busca (Google, Bing, DuckDuckGo, etc.) sem rastrear o usuário.
• Instância SearXNG Configurável: Funciona com qualquer instância pública ou auto-hospedada do SearXNG por meio de sua API JSON.
• Suporte à Paginação: Busca páginas adicionais de resultados para pesquisas abrangentes.
• Controle de Busca Segura: Filtra conteúdo explícito com níveis configuráveis.
• Resultados Estruturados: Retorna resultados limpos e analisados, otimizados para consumo por LLMs.
• Implantação Fácil: Execute via npx, Docker ou localmente, com variantes disponíveis em Node.js/Python/Go.
• Compatibilidade Multi-Clientes: Funciona perfeitamente com Claude Desktop, Cursor, Windsurf e outras ferramentas compatíveis com MCP.

Casos de Uso

• Pesquisa Fundamentada: Permita que o Claude busque informações atualizadas para respostas precisas, em vez de depender de dados de treinamento desatualizados.
• Fluxos de Trabalho de IA Locais/Privados: Combine com Ollama ou LM Studio para configurações de agentes totalmente offline (exceto a busca).
• Assistência em Programação: Pesquise documentação, bibliotecas ou mensagens de erro em tempo real durante o desenvolvimento.
• Notícias e Eventos Atuais: Obtenha os últimos artigos e resumos sem anúncios ou conteúdo patrocinado.
• Orquestração Multi-Ferramentas: Associe a outros servidores MCP (navegador, bancos de dados, execução de código) para agentes autônomos poderosos.

Como Funciona

1. Execute o servidor MCP (processo local ou container Docker).
2. Configure seu cliente MCP (por exemplo, Claude Desktop) para conectar-se a ele.
3. A IA descobre a ferramenta searxng_web_search automaticamente.
4. Quando o agente precisa de dados recentes da web, ele chama a ferramenta via protocolo MCP.
5. O servidor consulta sua instância escolhida do SearXNG e retorna resultados estruturados.

Instalação Rápida & Configuração (Versão Mais Popular para Node.js)

Usando npx (mais fácil):

Adicione o seguinte à sua configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.example.com"
      }
    }
  }
}

Recomendado: SearXNG auto-hospedado para máxima privacidade (execute via Docker a partir do repositório oficial do SearXNG).

Opção Docker:

docker pull mcpcommunity/ihor-sokoliuk-mcp-searxng:latest

Outras implementações notáveis:

• Variantes em Python/uv (ex.: The-AI-Workshops)
• Versão em Go para alto desempenho
• Forks aprimorados com suporte a scraping ou categorias

Opções de Configuração

• SEARXNG_URL: URL da sua instância SearXNG (pública ou privada).
• Suporte a proxy e autenticação em vários forks.
• Nível de pesquisa segura e categorias de resultados (geral, notícias, imagens, etc.).

Reinicie seu cliente MCP após adicionar o servidor. A ferramenta deve aparecer automaticamente nas ferramentas disponíveis do agente.

Dicas Comuns

• Use uma instância SearXNG auto-hospedada para obter melhor privacidade e confiabilidade.
• Instâncias públicas funcionam para testes rápidos, mas podem ter limites de taxa ou indisponibilidade.
• Combine com ferramentas de captura de página para pesquisas mais profundas (muitos forks incluem extração de conteúdo).

O SearXNG MCP é uma das ferramentas de pesquisa na web com foco em privacidade mais amplamente usadas no ecossistema MCP, tornando-se essencial para qualquer pessoa que construa ou use agentes de IA com foco em local-first ou preocupados com privacidade.

Para a versão mais recente e documentação completa, visite o repositório principal.