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
- 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úsquedapage (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:8080SEARXNG_USER_AGENT : encabezado de agente de usuario personalizado para solicitudes. Predeterminado: MCP-SearXNG/1.0NODE_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.