searxng-mcp

Un servidor MCP para SearXNG que mantiene la salida visible para el modelo breve, preserva los payloads completos de los resultados en metadatos ocultos y admite tanto clientes stdio locales como el uso de streamable-http desplegado.

Qué obtienes

• search para una búsqueda web concisa con payloads sin procesar completos en _meta

• search_many para fan-out en paralelo, deduplicación y clasificación combinada

• search_and_fetch para búsqueda más extracción de fuentes en una sola llamada

• research para búsqueda de consultas múltiples con extracciones por lotes y fuentes combinadas

• fetch_url para extracción de páginas legibles con citas

• fetch_many para extracción de URL en paralelo con almacenamiento en caché

• health para el estado del backend, la caché y el renderizado

El servidor está diseñado para ser ligero. SearXNG realiza el trabajo de búsqueda; searxng-mcp maneja el formato de herramientas, el almacenamiento en caché, la extracción y el transporte.

Related MCP server: SearXNG MCP Bridge

Inicio rápido

Instalar desde un checkout

uv sync
uv run searxng-mcp

Instalar con uvx

searxng-mcp se distribuye desde este repositorio (sin lanzamiento en PyPI). El camino más corto es:

uvx --from git+https://github.com/88plug/searxng-mcp searxng-mcp

La extracción renderizada se incluye en la instalación predeterminada. Si el host ya tiene Chromium o Chrome, searxng-mcp lo utiliza. De lo contrario, la primera extracción renderizada arranca Playwright Chromium en la caché del usuario automáticamente.

Ejecutar con Docker

docker build -t searxng-mcp .
docker run --rm -p 8811:8811 --add-host=host.docker.internal:host-gateway \
  -e SEARXNG_MCP_BASE_URL=http://host.docker.internal:8890 \
  searxng-mcp

Ejemplo de Claude Desktop

{
  "mcpServers": {
    "searxng-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/88plug/searxng-mcp", "searxng-mcp"],
      "env": {
        "SEARXNG_MCP_BASE_URL": "http://127.0.0.1:8890",
        "SEARXNG_MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Modos de despliegue

stdio local

Úselo para clientes de escritorio y flujos de trabajo privados. Es el modo más simple y seguro.

SEARXNG_MCP_TRANSPORT=stdio uv run searxng-mcp

HTTP transmitible

Úselo para un servicio privado, un despliegue de equipo o un endpoint interno con proxy inverso.

SEARXNG_MCP_TRANSPORT=streamable-http uv run searxng-mcp --host 0.0.0.0 --port 8811

Docker y Compose reforzados

Para un servicio autohospedado de larga duración, utilice la variante de contenedor reforzada y la pila de Compose proporcionada.

docker build -f Dockerfile.prod -t searxng-mcp:prod .
cp docker-compose.env.example .env
docker compose up --build -d

Seguridad y confianza

Este proyecto es seguro para uso local y en redes de confianza. No es un servicio de Internet público listo para usar.

• fetch_url y fetch_many pueden obtener URL arbitrarias proporcionadas por el cliente

• la extracción renderizada puede iniciar Chromium contra páginas no confiables

• streamable-http debe colocarse detrás de una autenticación o un proxy inverso para cualquier despliegue compartido

• SEARXNG_MCP_FETCH_VERIFY_TLS=0 es solo para configuraciones de backend privadas o autofirmadas

Si expone el transporte HTTP, trátelo como un servicio interno y añada los controles que esperaría para cualquier herramienta capaz de SSRF.

Por qué existe esto

• salida compacta visible para el modelo, con detalles completos preservados en metadatos ocultos

• flujos de trabajo de investigación más rápidos mediante búsqueda en paralelo y fan-out de extracción

• extracción renderizada para páginas con mucho JS sin banderas de instalación adicionales

• despliegue autohospedable para personas que desean su propio servidor MCP respaldado por SearXNG

Superficie MCP

• searxng://config expone la configuración actual, el modo de transporte y el soporte de renderizado

• searxng://guide resume las herramientas disponibles y cuándo usarlas

• quick_lookup, deep_research y research_workflow son prompts de compatibilidad opcionales para clientes que admiten superficies de prompt

Entorno

Variables clave:

• SEARXNG_MCP_BASE_URL: URL base de SearXNG, predeterminado http://127.0.0.1:8890

• SEARXNG_MCP_FALLBACK_BASE_URLS: instancias de SearXNG de respaldo opcionales separadas por comas

• SEARXNG_MCP_TRANSPORT: stdio, streamable-http o sse

• SEARXNG_MCP_SEARCH_TIMEOUT: tiempo de espera de búsqueda del backend en segundos

• SEARXNG_MCP_FETCH_TIMEOUT: tiempo de espera de extracción en segundos

• SEARXNG_MCP_SEARCH_CACHE_TTL: TTL de la caché de búsqueda en segundos

• SEARXNG_MCP_FETCH_CACHE_TTL: TTL de la caché de extracción en segundos

• SEARXNG_MCP_FETCH_VERIFY_TLS: establecer en 0 para omitir la verificación TLS en las extracciones

• SEARXNG_MCP_RENDER_TIMEOUT: tiempo de espera de navegación del navegador para extracciones renderizadas

• SEARXNG_MCP_RENDER_WAIT_MS: espera adicional después de la carga del contenido DOM para extracciones renderizadas

• SEARXNG_MCP_RENDER_CONCURRENCY: límite de extracción renderizada concurrente

• SEARXNG_MCP_RENDER_HEADLESS: establecer en 0 para mostrar el navegador

• SEARXNG_MCP_RENDER_BROWSER_PATH: ruta explícita del binario de Chromium o Chrome

• SEARXNG_MCP_RENDER_SANDBOX: establecer en 1 para mantener habilitado el sandboxing de Chromium

• SEARXNG_MCP_RENDER_BLOCK_RESOURCES: establecer en 0 para permitir imágenes, fuentes, hojas de estilo y medios durante el renderizado

• SEARXNG_MCP_RENDER_AUTO_FALLBACK: establecer en 0 para deshabilitar el respaldo renderizado automático

• SEARXNG_MCP_RENDER_AUTO_MIN_WORDS: reduzca esto para hacer que el auto-renderizado sea más agresivo

• SEARXNG_MCP_RENDER_AUTO_MIN_CHARS: reduzca esto para hacer que el auto-renderizado sea más agresivo

• SEARXNG_MCP_CACHE_DIR: ruta del directorio de caché

Benchmarks

uv run searxng-mcp-bench --rounds 3

Los informes de benchmark:

• latencia del backend de SearXNG sin procesar

• tamaño de salida de búsqueda visible para el token

• latencia de búsqueda de consultas múltiples combinadas

• latencia de investigación de consultas múltiples

• latencia de extracción de búsqueda

• latencia de extracción renderizada

• latencia de extracción por lotes

• latencia de extracción por lotes renderizada

Documentación

• Descripción general del sitio de documentación

• Primeros pasos

• Despliegue

• Seguridad

• Referencia de herramientas

• Configuraciones de cliente

• Comparación

• Registro de cambios

• Documentación de SearXNG

Construcción y prueba

uv sync --all-groups
uv run pytest -q
uv run python -m compileall src
uv run mkdocs build --strict

Mantenimiento de dependencias

Verificaciones manuales:

uv lock --upgrade --dry-run
uvx --from pip-audit pip-audit

Verificaciones automatizadas:

• PRs semanales de Dependabot para dependencias de uv y GitHub Actions

• flujo de trabajo semanal de Dependency Health para escaneo de vulnerabilidades y simulacros de actualización