SearXNG MCP Server

Servidor MCP de SearXNG

Una implementación de servidor MCP que integra la API de SearXNG, proporcionando capacidades de búsqueda web.

Características

• Búsqueda web: Consultas generales, noticias, artículos, con paginación.
• Paginación: Controla qué página de resultados recuperar.
• Filtrado por tiempo: Filtra resultados por rango de tiempo (día, mes, año).
• Selección de idioma: Filtra resultados por idioma preferido.
• Búsqueda segura: Controla el nivel de filtrado de contenido para los resultados de búsqueda.

Herramientas

• searxng_web_search

  • Ejecuta búsquedas web con paginación
  • Entradas:
    • query (cadena): La consulta de búsqueda. Esta cadena se pasa a los servicios de búsqueda externos.
    • pageno (número, opcional): Número de página de búsqueda, comienza en 1 (por defecto 1)
    • time_range (cadena, opcional): Filtra resultados por rango de tiempo: uno de "day", "month", "year" (por defecto: ninguno)
    • language (cadena, opcional): Código de idioma para los resultados (por ejemplo, "en", "fr", "de") o "all" (por defecto: "all")
    • safesearch (número, opcional): Nivel de filtro de búsqueda segura (0: Ninguno, 1: Moderado, 2: Estricto) (por defecto: configuración de la instancia)

• web_url_read

  • Lee y convierte el contenido de una URL a markdown
  • Entradas:
    • url (cadena): La URL a obtener y procesar

Configuración

Configurar SEARXNG_URL

1. Elige una instancia de SearxNG de la lista de instancias públicas o usa tu entorno local.
2. Establece la variable de entorno SEARXNG_URL a la URL de la instancia.
3. El valor por defecto de SEARXNG_URL es http://localhost:8080.

Uso de autenticación

Si estás usando una instancia de SearxNG protegida por contraseña, puedes establecer un nombre de usuario y contraseña para autenticación básica HTTP:

• Establece la variable de entorno AUTH_USERNAME a tu nombre de usuario
• Establece la variable de entorno AUTH_PASSWORD a tu contraseña

Uso con Claude Desktop

NPX

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

NPM

npm install -g mcp-searxng

Y luego en tu archivo de configuración MCP:

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Docker

Usando imagen precompilada de Docker Hub

docker pull isokoliuk/mcp-searxng:latest

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Compilar localmente

docker build -t mcp-searxng:latest -f Dockerfile .

Uso

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.