hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'd'.
Included as one of the search engines that SearXNG queries for results, configured with the shortcut 'g'.
Integrates with SearXNG to provide privacy-focused meta search capabilities, combining results from multiple search engines with features like language support, time range filtering, and safe search.

Servidor MCP SearXNG

Una implementación de servidor MCP que se integra con SearXNG y proporciona capacidades de metabúsqueda centradas en la privacidad.

Características

Metabúsqueda : combina resultados de múltiples motores de búsqueda
Centrado en la privacidad : sin seguimiento ni elaboración de perfiles de usuario
Varias categorías : Admite contenido general, noticias, ciencia, archivos, imágenes, vídeos y más.
Compatibilidad con idiomas : búsqueda en idiomas específicos o en todos los idiomas
Filtrado de rango de tiempo : filtre los resultados por día, semana, mes o año
Búsqueda segura : tres niveles de filtrado de búsqueda segura
Soporte de respaldo : múltiples instancias de SearXNG para mayor confiabilidad

Instalación

npm install -g @kevinwatt/mcp-server-searxng

Uso

Ejecución directa

mcp-server-searxng

Con Dive Desktop

Haga clic en "+ Agregar servidor MCP" en Dive Desktop
Copie y pegue esta configuración:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

Haga clic en "Guardar" para instalar el servidor MCP

Documentación de herramientas

búsqueda web
- Ejecutar metabúsquedas en múltiples motores
- Entradas:
  - query (cadena): Términos de búsqueda
  - page (número, opcional): Número de página (predeterminado: 1)
  - language (cadena, opcional): código de idioma (por ejemplo, 'en', 'all', predeterminado: 'all')
  - categories (matriz, opcional): categorías de búsqueda (predeterminado: ['general'])
    - Disponible: "general", "noticias", "ciencia", "archivos", "imágenes", "vídeos", "música", "redes sociales", "eso"
  - time_range (cadena, opcional): filtro de tiempo (día/semana/mes/año)
  - safesearch (número, opcional): Nivel de búsqueda segura (0: Ninguno, 1: Moderado, 2: Estricto, predeterminado: 1)

Desarrollo

git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.

Prerrequisitos

Necesita una instancia local de SearXNG ejecutándose. Para configurarla:

Ejecutar SearXNG con Docker

Inicio rápido

# Create config directory
mkdir -p searxng

# Create config file
tee searxng/settings.yml << EOF
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE"  # Generate a random key
  port: 8080

search:
  safe_search: 0
  formats:
    - html
    - json

engines:
  - name: google
    engine: google
    shortcut: g

  - name: duckduckgo
    engine: duckduckgo
    shortcut: d

  - name: bing
    engine: bing
    shortcut: b

server.limiter: false
EOF

# Start container
docker run -d \
  --name searxng \
  -p 8080:8080 \
  -v "$(pwd)/searxng:/etc/searxng" \
  searxng/searxng

Función de búsqueda de prueba

# Test JSON API with curl
curl -v 'http://localhost:8080/search?q=test&format=json'

# Or visit in browser
http://localhost:8080/search?q=test

Gestión de contenedores

# Stop container
docker stop searxng

# Remove container
docker rm searxng

# View container logs
docker logs searxng

# Enable auto-start on boot
docker update --restart always searxng

El indicador --restart always garantiza que:

El contenedor se inicia automáticamente cuando se inicia el demonio Docker
El contenedor se reinicia automáticamente si se bloquea
El contenedor se reinicia automáticamente si se detiene a menos que el usuario lo detenga explícitamente

Configuración personalizada

Edite searxng/settings.yml a:

Modificar la lista de motores de búsqueda
Ajustar la configuración de seguridad
Configurar el idioma de la interfaz de usuario
Cambiar los límites de la API

Para conocer las opciones de configuración detalladas, consulte la documentación de SearXNG

Variables de entorno

SEARXNG_INSTANCES : Lista separada por comas de URL de instancias de SearXNG. Predeterminado: http://localhost:8080
SEARXNG_USER_AGENT : encabezado de agente de usuario personalizado para solicitudes. Predeterminado: MCP-SearXNG/1.0
NODE_TLS_REJECT_UNAUTHORIZED : Establezca en '0' para omitir la verificación del certificado SSL (para el desarrollo con certificados autofirmados) Valor predeterminado: indefinido (verificación SSL habilitada)

Ejemplo de configuración con todas las opciones:

{
  "mcpServers": {
    "searxng": {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ],
      "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

⚠️ Advertencia: No se recomienda deshabilitar la verificación del certificado SSL en entornos de producción.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

web_search

Este servidor proporciona una capacidad de metabúsqueda centrada en la privacidad al integrar múltiples motores de búsqueda sin seguimiento ni creación de perfiles de usuario, y admite varias categorías e idiomas para búsquedas filtradas.

Related Resources

Reddit Discussion about this server

SearXNG MCP Server