Home / MCP / MCP-searxng MCP Server

MCP-searxng MCP Server

Provides an MCP interface to connect agents with searXNG for web search.

python

107stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "searxng": {
            "command": "uvx",
            "args": [
                "mcp-searxng"
            ],
            "env": {
                "SEARXNG_URL": "http://localhost:8080"
            }
        }
    }
}

You can connect agentic systems to search capabilities via searXNG using this MCP server. It lets you run searXNG-backed web searches from an MCP client, coordinating searches and returning results to your agents.

How to use

You integrate the MCP server with your client so your agents can perform web searches through searXNG. Configure the MCP client to point at the searXNG MCP server, then initiate a search from your agent. The server exposes a search capability that you can call from your workflows, and it will return relevant results sourced from searXNG.

How to install

Prerequisites: you need a runtime environment capable of running MCP servers and the appropriate command tools installed (uvx and uv). Ensure you have access to your searXNG instance or have a local searXNG server you can reach.

Step 1. Add the MCP server configuration to your client setup using one of the provided methods. You will run the MCP server via your MCP client by referencing the searxng configuration key.

Step 2. Use one of the following configurations to start the MCP server from your client environment.

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

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

Notes on searXNG URL and environment

Set the environment variable SEARXNG_URL to the URL of your searXNG server. The default is http://localhost:8080 if you are running locally.

Start the MCP client and you should be able to perform web searches through searXNG via the MCP interface.

Additional considerations

If you are using a development environment that requires restarting the MCP server, ensure any previous processes are terminated before starting a new one to avoid port conflicts.

Configuration and environment reminders

Environment variables shown for runtime are optional but recommended for pointing to your searXNG instance. Include SEARXNG_URL in your environment when starting the MCP server.

Available tools

search

Performs a web search using searXNG, returning results to the MCP client.