MCP.so
Sign In
S

SearXNG MCP server

@nik-sharky

Repository

About SearXNG MCP server

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

#search#searxng#self-hosted-search

Basic information

Category

Search

Transports

stdio

Publisher

nik-sharky

Submitted by

Nik

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.

Comments

More Search MCP servers

G-Search MCP

jae-jae

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

268

Perplexity MCP Zerver

wysh3

MCP web search using perplexity without any API KEYS

93

Baidu AI Search

baidubce

appbuilder-sdk, 千帆AppBuilder-SDK帮助开发者灵活、快速的搭建AI原生应用

583

🚀 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

Naver Search MCP Server

isnow890

MCP server for Naver Search API integration. Provides comprehensive search capabilities across Naver services (web, news, blog, shopping, etc) and data trend analysis tools via DataLab API.

77