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

Related MCP server: Wuxing Search MCP

Instalación

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

Uso

Ejecución directa

mcp-server-searxng

Con Dive Desktop

1. Haga clic en "+ Agregar servidor MCP" en Dive Desktop

2. Copie y pegue esta configuración:

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

3. 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.