Searxng MCP Server

A Python client for interacting with local/LAN SearXNG instances.

Remote serverstreamable-httpPython

What is the Searxng MCP Server?

A Python client for interacting with local/LAN SearXNG instances.

What you get

A Python client library crafted by JamePeng (jame_peng@sina.com) for seamless interaction with your self-hosted SearXNG instance. This library empowers you to programmatically perform various searches (text, images, videos, news, etc.) against your local or LAN-deployed SearXNG server, giving you full control over your search data without relying on external APIs.

  • Connect to Local/LAN SearXNG: — Easily specify the base URL (IP address and port) of your self-hosted SearXNG instance, supporting both local and network-accessible deployments
  • Text Search: — Perform general web searches and retrieve structured results
  • Structured Output: — Receive search results in a clean, parseable JSON format
  • Robust Error Handling: — Comprehensive error management for network issues, server responses, and parsing failures
  • Customizable: — Extendable to support more SearXNG categories and search types

Configuration and credentials

  • Python 3.9+: Ensure you have a compatible Python version installed. * Docker & Docker Compose: (Recommended for setting up SearXNG) Make sure Docker and Docker Compose are installed on your system.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Searxng MCP Server

{
  "mcpServers": {
    "searxng-search": {
      "command": "uvx",
      "args": ["build"],
      "env": {
        "SEARXNG_HOST": "your-value",
        "SEARXNG_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.9+: Ensure you have a compatible Python version installed. * Docker & Docker Compose: (Recommended for setting up SearXNG) Make sure Docker and Docker Compose are installed on your system.
VariableDescriptionRequired
SEARXNG_HOSTEndpoint or connection string the server talks to.Optional
SEARXNG_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Searxng to Prerequisites.”

Frequently asked questions

A Python client for interacting with local/LAN SearXNG instances. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.