convez.ai
MCP ServerBusca & PesquisaIntermediário
lord2800

MCP SearXNG

lord2800/mcp-searxng

Busca web descentralizada via SearXNG para Claude e clientes MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em Rust que expõe uma ferramenta de busca web integrada ao SearXNG, permitindo consultas a instâncias auto-hospedadas ou públicas. Inclui retry exponencial, timeout configurável e suporte a filtros por linguagem, categorias e período.

Instalação

$npx convez-ai lord2800/mcp-searxng

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Integrar busca web privada em agents Claude sem depender de APIs comerciais
  • Pesquisa com filtros avançados (linguagem, categoria, período) em tempo real
  • Aumentar contexto de LLMs com resultados de SearXNG auto-hospedado

Veredito

Implementação sólida de MCP server para SearXNG com retry resiliente e configuração flexível. Útil para quem busca alternativa descentralizada às APIs comerciais de busca, embora exija instância SearXNG operacional.

README

A tradução para o português deste README ainda está na fila.

mcp-searxng

An MCP (Model Context Protocol) server that exposes a web_search tool backed by SearXNG.

Features

  • Web search via SearXNG — queries any self-hosted or public SearXNG instance
  • Exponential backoff retry — only network errors and HTTP 5xx are retried; 4xx responses are returned immediately
  • Configurable timeout & retries — set per-request timeout and max retry count via CLI flags
  • Graceful shutdown — Ctrl-C / SIGTERM signals trigger clean shutdown

Building

cargo build --release

The binary will be at target/release/mcp-searxng.

Usage

CLI Options

FlagDescriptionDefault
--transportWhich transport to use (http or stdio)stdio
-b, --base-urlBase URL of the SearXNG instancehttp://localhost:8080
-r, --retry-countNumber of retry attempts for transient failures3
-t, --http-timeout-secsPer-request HTTP timeout in seconds2
-a, --bind-addrBind address for HTTP transport127.0.0.1
-p, --portPort for HTTP transport8081

Running

# With defaults (SearXNG at localhost:8080)
cargo run

# Custom SearXNG instance
cargo run -- -b http://my-server:8080 -r 5 -t 3

The server uses stdio transport — pipe it to an MCP client like Claude Desktop, Cursor, or VS Code.

Configuring in Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "web-search": {
      "command": "path/to/mcp-searxng",
      "args": ["-b", "http://localhost:8080"]
    }
  }
}

Tool Schema

The web_search tool accepts the following parameters:

ParameterTypeRequiredDescriptionDefault
querystringyesThe search query string—
pageintegernoPage number for pagination1
languagestringnoLanguage filter (e.g., "en", "fr")'all'
categoriesarray<string>noCategory filters (e.g., ["general", "news"])all categories
time_rangestringnoTime range ("day", "week", "month", "year")empty

Retry Policy

  • Retryable: network errors (timeout, connection refused) and HTTP 5xx responses
  • Non-retryable: HTTP 4xx responses — returned immediately as valid results
  • Backoff: exponential starting at 1s, doubling each attempt, capped at 30s

License

AGPL-3.0-or-later

Ver o original no GitHub

Bom para

Relacionados