searxng

Runs an MCP server that forwards queries to a searxng instance at a given URL.

other

1

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-maccam912_searxng-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "https://raw.githubusercontent.com/maccam912/searxng-mcp-server/refs/heads/main/server.py",
        "--url",
        "https://searxng.example.com"
      ]
    }
  }
}

You run an MCP server that forwards queries to a searxng instance at a specified URL, enabling you to expose a search gateway through the MCP protocol while delegating actual query processing to your searxng deployment. This lets you wire searxng-based search capabilities into MCP-compatible clients and workflows without embedding all logic in the client itself.

How to use

Start the MCP server using the runtime command and URL provided. The server will listen for MCP requests and route them to your searxng instance at the configured URL. Connect your MCP client to the server using the standard MCP client pattern for this host, and you can perform search-related actions by sending requests that the searxng backend will handle.

How to install

Prerequisites you should have before starting: ensure you have a runtime capable of executing the MCP server command (for example, a JavaScript/Node environment or a compatible runtime that provides the uv runner). Make sure you can access the internet from the machine where you install and run the server.

Install the MCP server runtime/tooling if not already present on your system. This step is necessary to execute the MCP server command shown later.

Run the MCP server using the exact command snippet shown below to start the server and point it at your searxng URL.

uv run https://raw.githubusercontent.com/maccam912/searxng-mcp-server/refs/heads/main/server.py --url https://searxng.example.com

Additional notes

This MCP server configuration uses a stdio-based approach, invoking the uv runner to execute a Python-based server script hosted at a remote URL. The server will expose MCP endpoints that your clients can consume, while delegating actual search logic to the searxng instance identified by the --url parameter.