SearXNG MCP server

@nik-sharky

About SearXNG MCP server

A Model Context Protocol (MCP) server that provides web search capabilities by integrating with a SearXNG instance.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "searxng-mcp-nik-sharky": {
      "command": "python",
      "args": [
        "searxng_mcp.py",
        "--transport",
        "http",
        "--port",
        "32123",
        "--searxng",
        "http://searx.lan"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is SearXNG MCP server?

A Model Context Protocol (MCP) server that provides web search capabilities by integrating with a SearXNG instance. It aggregates results from over 130 engines and supports advanced search parameters for precise queries.

How to use SearXNG MCP server?

Install Python 3.10+, clone the repository, and install dependencies with pip install -r requirements.txt. Run the server using python searxng_mcp.py --transport http --port 32123 --searxng http://your-searxng-instance:8080. Configuration can be set via environment variables (SEARXNG_URL, MCP_PORT, MCP_HOST) or command-line arguments. Docker is also supported for containerized deployment.

Key features of SearXNG MCP server

Aggregated web search across 130+ engines.
Programmatic discovery of categories and engines.
Supports stdio, HTTP, and SSE transports.
Flexible configuration via environment variables and CLI.
Advanced parameters: categories, engines, language, pageno, time_range, safesearch.

Use cases of SearXNG MCP server

Integrate aggregated web search into AI agents or assistants.
Retrieve specialized content (images, news, science, maps) programmatically.
Dynamically adapt to available engines and categories via discovery tools.
Deploy a stateless search service for scalable, multi-client environments.

FAQ from SearXNG MCP server

What prerequisites are needed to run SearXNG MCP server?

Python 3.10+ and a running SearXNG instance (accessible via HTTP) are required.

How do I configure the server?

Set SEARXNG_URL, MCP_PORT, and MCP_HOST in a .env file, or pass them as command-line arguments (e.g., --searxng http://instance:8080).

What transport options are available?

The server supports stdio (default for some clients), http (stateless HTTP), and sse (Server-Sent Events) transports.

How can I filter search results?

Use the categories (e.g., news,it), engines (e.g., google,wikipedia), language, pageno, time_range (day, month, year), and safesearch (0–2) parameters.

Can I discover available categories and engines dynamically?

Yes, the searxng_get_info tool returns the list of enabled categories and engines from your SearXNG instance.

Frequently asked questions

What prerequisites are needed to run SearXNG MCP server?

Python 3.10+ and a running SearXNG instance (accessible via HTTP) are required.

How do I configure the server?

Set `SEARXNG_URL`, `MCP_PORT`, and `MCP_HOST` in a `.env` file, or pass them as command-line arguments (e.g., `--searxng http://instance:8080`).

What transport options are available?

The server supports `stdio` (default for some clients), `http` (stateless HTTP), and `sse` (Server-Sent Events) transports.

How can I filter search results?

Use the `categories` (e.g., `news,it`), `engines` (e.g., `google,wikipedia`), `language`, `pageno`, `time_range` (`day`, `month`, `year`), and `safesearch` (0–2) parameters.

Can I discover available categories and engines dynamically?

Yes, the `searxng_get_info` tool returns the list of enabled categories and engines from your SearXNG instance.

Comments

Basic information

More Search MCP servers

Google Search Console MCP Server

ahonn

A Model Context Protocol (MCP) server providing access to Google Search Console

239

3gpp-mcp

higebu

An MCP (Model Context Protocol) server that makes 3GPP specifications accessible to LLMs.

G-Search MCP

jae-jae

A powerful MCP server for Google search that enables parallel searching with multiple keywords simultaneously.

268

Kagi MCP server

kagisearch

The Official Model Context Protocol (MCP) server for Kagi Search & other tools.

435

Google News MCP Server

ChanMeng666

【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.

124