Servidor MCP de SearXNG

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA realizar búsquedas web mediante SearXNG , un metabuscador que respeta la privacidad. Funciona de inmediato, sin necesidad de implementación adicional, seleccionando automáticamente una instancia aleatoria de SearX.space y, a la vez, admite instancias privadas con autenticación básica.

Características

Configuración sin necesidad de configuración : funciona inmediatamente mediante el uso de una instancia pública aleatoria de SearX.space
Compatibilidad con instancias privadas : conéctese a su propia instancia de SearXNG con autenticación básica opcional
Realizar búsquedas web con parámetros personalizables
Compatibilidad con múltiples motores de búsqueda
Resultados de búsqueda centrados en la privacidad
Resultados de búsqueda con formato Markdown
Valores predeterminados razonables para todos los parámetros

ADVERTENCIA: Es posible que las instancias públicas no estén disponibles para este propósito y devuelvan "Solicitud fallida con código de estado 429".

Instalación

Prerrequisitos

Node.js (v16 o superior)
npm (v7 o superior)
Acceso a una instancia de SearXNG (autoalojada o pública)

Instalar desde la fuente

# Clone the repository
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuración

El servidor SearXNG MCP se puede configurar con las siguientes variables de entorno:

SEARXNG_URL (opcional): La URL de su instancia de SearXNG (p. ej., https://searx.example.com ). Si no se proporciona, se seleccionará automáticamente una instancia pública aleatoria de SearX.space , lo que permitirá el uso del servidor sin necesidad de implementarlo.
USE_RANDOM_INSTANCE (opcional): Establézcalo en "false" para deshabilitar la selección aleatoria de instancias cuando no se proporciona una URL. El valor predeterminado es "true".
SEARXNG_USERNAME (opcional): Nombre de usuario para la autenticación básica al conectarse a una instancia privada
SEARXNG_PASSWORD (opcional): Contraseña para la autenticación básica al conectarse a una instancia privada

Puede configurar estas variables de entorno en un archivo .env en el directorio raíz del proyecto:

SEARXNG_URL=https://searx.example.com
SEARXNG_USERNAME=your_username
SEARXNG_PASSWORD=your_password

Uso

Ejecutando el servidor

# If installed globally
searxngmcp

# If installed from source
node build/index.js

Integración con Claude Desktop

Abra Claude Desktop
Vaya a Configuración > Servidores MCP
Agregue un nuevo servidor MCP con la siguiente configuración:
{ "mcpServers": { "searxngmcp": { "command": "searxngmcp", "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } }

Integración con Claude en VSCode

Abrir VSCode
Vaya a Configuración > Extensiones > Claude > Configuración de MCP
Agregue un nuevo servidor MCP con la siguiente configuración:
{ "mcpServers": { "searxngmcp": { "command": "node", "args": ["/path/to/searxng-mcp/build/index.js"], "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } }

Uso con Smolagents

SearXNG MCP se integra fácilmente con Smolagents, un framework ligero para crear agentes de IA. Esto permite crear potentes agentes de investigación que pueden buscar en la web y procesar los resultados:

from smolagents import CodeAgent, LiteLLMModel, ToolCollection
from mcp import StdioServerParameters

# Configure the SearXNG MCP server
server_parameters = StdioServerParameters(
    command="node",
    args=["path/to/searxng-mcp/build/index.js"],
    env={
        "SEARXNG_URL": "https://your-searxng-instance.com",
        "SEARXNG_USERNAME": "your_username",  # Optional
        "SEARXNG_PASSWORD": "your_password"   # Optional
    }
)

# Create a tool collection from the MCP server
with ToolCollection.from_mcp(server_parameters) as tool_collection:
    # Initialize your LLM model
    model = LiteLLMModel(
        model_id="your-model-id",
        api_key="your-api-key",
        temperature=0.7
    )
    
    # Create an agent with the search tools
    search_agent = CodeAgent(
        name="search_agent",
        tools=tool_collection.tools,
        model=model
    )
    
    # Run the agent with a search prompt
    result = search_agent.run(
        "Perform a search about: 'climate change solutions' and summarize the top 5 results."
    )
    
    print(result)

Herramientas disponibles

búsqueda de búsqueda

Realice búsquedas web con SearXNG, un metabuscador que respeta la privacidad. Ofrece contenido web relevante con parámetros personalizables.

Parámetros

Parámetro	Tipo	Descripción	Por defecto	Requerido
consulta	cadena	Consulta de búsqueda	-	Sí
idioma	cadena	Código de idioma para los resultados de búsqueda (por ejemplo, 'en', 'de', 'fr')	'en'	No
rango de tiempo	cadena	Intervalo de tiempo para los resultados de búsqueda. Opciones: día, semana, mes, año.	nulo	No
categorías	matriz de cadenas	Categorías para buscar (por ejemplo, 'general', 'imágenes', 'noticias')	nulo	No
motores	matriz de cadenas	Motores de búsqueda específicos para utilizar	nulo	No
búsqueda segura	número	Nivel de búsqueda segura: 0 (desactivado), 1 (moderado), 2 (estricto)	1	No
pageno	número	Número de página de resultados. Debe ser mínimo 1.	1	No
resultados máximos	número	Número máximo de resultados de búsqueda. Rango: 1-50	10	No

Ejemplo

// Example request
const result = await client.callTool('searxngsearch', {
  query: 'climate change solutions',
  language: 'en',
  time_range: 'year',
  categories: ['general', 'news'],
  safesearch: 1,
  max_results: 5
});

Desarrollo

Configuración

# Clone the repository
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# Install dependencies
npm install

Construir

npm run build

Modo de observación (para desarrollo)

npm run watch

Pruebas con MCP Inspector

npm run inspector

Licencia

Instituto Tecnológico de Massachusetts (MIT)

SearXNG MCP Server

Integrations

Servidor MCP de SearXNG

Características

Instalación

Prerrequisitos

Instalar desde la fuente

Configuración

Uso

Ejecutando el servidor

Integración con Claude Desktop

Integración con Claude en VSCode

Uso con Smolagents

Herramientas disponibles

búsqueda de búsqueda

Parámetros

Ejemplo

Desarrollo

Configuración

Construir

Modo de observación (para desarrollo)

Pruebas con MCP Inspector

Licencia

Appeared in Searches