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: MCP Google Server

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"
      }
    }
  }
}