search-web

SearXNG Search▌

by secretiveshell

Use SearXNG metasearch engine for private web searches, a great alternative to the Duck Duck Go search engine and browse

Perform privacy-preserving web searches via the SearXNG metasearch engine.

github stars

★ 115

GitHub npm

Privacy-respecting searchOptimized for LLM context windowsNo installation required with pipx/uvx

best for

/ Users who prioritize privacy over mainstream search engines
/ AI assistants needing web search without tracking
/ Organizations running their own SearxNG instances

capabilities

/ Search the web through SearxNG instances
/ Configure search parameters like result count and language
/ Filter results by time range
/ Get formatted search results optimized for LLMs

what it does

Connects to SearxNG privacy-focused search engines to provide web search capabilities for AI assistants. Lets you search the web without tracking while preserving context window space.

about

SearXNG Search is a community-built MCP server published by secretiveshell that provides AI assistants with tools and capabilities via the Model Context Protocol. Use SearXNG metasearch engine for private web searches, a great alternative to the Duck Duck Go search engine and browse It is categorized under search web. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.

how to install

You can install SearXNG Search in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport. This server supports remote connections over HTTP, so no local installation is required.

license

MIT

SearXNG Search is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

MCP-searxng

An MCP server for connecting agentic systems to search systems via searXNG.

Tools

Search the web with SearXNG

Prompts

search(query: str) -> f"Searching for {query} using searXNG"

Usage

via uvx

configure your client JSON like

{
  "mcpServers": {
    "searxng": {
      "command": "uvx", 
      "args": [
        "mcp-searxng"
      ]
    }
  }
}

via git clone

Add the server to claude desktop (the entrypoint is main.py)

Clone the repo and add this JSON to claude desktop

you can run this server with uvx mcp-searxng, or use a local copy of the repo

{
  "mcpServers": {
    "searxng": {
      "command": "uv", 
      "args": [
        "--project",
        "/absoloute/path/to/MCP-searxng/",
        "run",
        "/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
      ]
    }
  }
}

you will need to change the paths to match your environment

Custom SearXNG URL

set the environment variable SEARXNG_URL to the URL of the searxng server (default is http://localhost:8080)
run your MCP client and you should be able to search the web with searxng

Note: if you are using claude desktop make sure to kill the process (task manager or equivalent) before running the server again