SearXNG

Provides a privacy-focused MCP server that orchestrates SearXNG meta-search across engines with safe search and language filtering.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-kevinwatt_mcp-server-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"
      }
    }
  }
}

You run an MCP server that connects to SearXNG to perform privacy-focused, multi-engine meta searches. It combines results from multiple engines, supports language and time-range filtering, offers safe search levels, and can rely on multiple SearXNG instances for reliability.

How to use

You use an MCP client to connect to the SearXNG MCP Server and perform meta searches across several engines from a single API. You can specify search terms, language preferences, categories like general, news, science, or images, and apply time-based filters. Use the Safe Search levels to control content results. To ensure reliability, you can configure multiple SearXNG instances as fallbacks.

How to install

Prerequisites: you need Node.js and npm installed on your system.

npm install -g @kevinwatt/mcp-server-searxng

Additional notes on usage with Dive Desktop

If you prefer a graphical setup, you can add the MCP server in Dive Desktop and load a ready-made configuration so the client starts the MCP server for you.

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

Configuration and environment variables

You can tune how the MCP server talks to SearXNG by configuring environment variables for the gateway. The following variables are shown as part of the setup to specify which SearXNG instances to query and the user agent to send.

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

Tool documentation: web_search

The web_search tool executes a meta search across multiple engines. You can specify the search query, page number, language, categories, time range, and safesearch level. This lets you assemble a comprehensive result set from diverse sources while applying user-friendly filters.

Inputs include: query (string), page (number, optional, default 1), language (string, optional, default all), categories (array, optional, default ['general']), time_range (string, optional), safesearch (number, optional, default 1).

Test and troubleshooting tips

After starting the MCP server, verify that it initializes correctly by running the server and observing startup messages. If you encounter connection issues, check that the specified SEARXNG_INSTANCES are reachable and that the SearXNG instance is accessible on the configured ports.

Security considerations

This MCP server is designed to be privacy-focused with no user profiling. Ensure your SearXNG instances are trusted and accessible only through secure channels, and keep your user agent and access endpoints up to date.

Available tools

web_search

Executes a meta search across multiple engines with configurable page, language, categories, time range, and safesearch.

Built by

VeilStrat

AI signals for GTM teams