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

SerpApi MCP Server

ilyazub

SerpApi MCP Server for Google and other search engine results

154

Google Search MCP Server

mixelpixx

MCP Server built for use with Claude Code, Claude Desktop, VS Code, Cline - enable google search and ability to follow links and research websites

249

Search Console Mcp

saurabhsharma2u

Search & analytics data as infrastructure — MCP server for Google Search Console, Bing Webmaster Tools, and GA4, designed for AI agents and automation.

205

🚀 OneSearch MCP Server: Web Search & Crawl & Scraper & Extract

yokingma

🚀 OneSearch MCP Server: Web Search & Scraper & Extract, Support agent-browser, SearXNG, Tavily, DuckDuckGo, Bing, etc.

127

小红书自动搜索评论工具（MCP Server 2.0）

chenningling

这是一款基于 Playwright 开发的小红书自动搜索和评论工具，作为 MCP Server，可通过特定配置接入 MCP Client（如Claude for Desktop），帮助用户自动完成登录小红书、搜索关键词、获取笔记内容及发布AI生成评论等操作。

436