searxng-mul

This MCP server enables multi-query parallel search against a SearXNG backend using the SearXNG Mul (multi-query) integration. It supports both stdio (default) and HTTP transport modes, allowing you to run multiple search queries in parallel and retrieve aggregated results. The server authenticates with a SearXNG instance (with optional Basic Auth) and exposes a simple MCP tool named search that accepts a list of queries and optional parameters like engines, categories, safesearch, and language. In HTTP mode, you can access a streamable JSON-RPC endpoint at /mcp and use the /health endpoint to verify readiness. To use, provide SEARXNG_URL and optional credentials, then invoke the search tool with an array of queries and any desired options. For local integration, you can run in stdio mode and pipe requests directly, or deploy with Docker for containerized operation.

Prerequisites:

• Node.js 18 or higher
• npm or yarn
• Git

From Source:

git clone <repository-url>
cd searxng-mul-mcp
npm install
npm run build
npm start

Docker Deployment: Create a docker-compose.yml file:

services:
  searxng-mul-mcp:
    image: ghcr.io/jae-jae/searxng-mul-mcp:latest
    environment:
      - SEARXNG_URL=https://your.searxng.com
      # Optional: Basic Auth
      # - USERNAME=your_username
      # - PASSWORD=your_password
    ports:
      - "3000:3000"

Run with:

docker-compose up -d

Notes:

• Ensure SEARXNG_URL points to a reachable SearXNG instance.
• If your SearXNG instance requires Basic Auth, set USERNAME and PASSWORD in environment or export them in your shell.
• The project includes Dockerfile and docker-compose configurations for easy deployment.

Tips and common considerations:

• Environment variables: SEARXNG_URL is required; USERNAME and PASSWORD are optional but needed for Basic Auth.
• Transport: Choose stdio for direct MCP client usage or http for a web-based, streamable JSON-RPC interface with /mcp and /health endpoints.
• HTTP mode: If enabled, ensure PORT is open and not conflicting with other services. You can customize HOST and PORT via environment variables.
• Debugging: Enable DEBUG=true to get verbose logs.
• SearXNG compatibility: The server integrates with SearXNG REST API; verify connectivity and permissions before heavy usage.
• If you modify configuration, regenerate the Claude Desktop config accordingly to ensure correct command and environment setup.