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