MCP-searxng

MCP-searxng

68
research_and_data

MCP-searxng is a server designed to connect agentic systems with search systems through the SearXNG platform, providing web search capabilities. It supports integration via configuration of JSON clients or git cloning for local setup, and allows custom URL configuration for the SearXNG server.

MCP-searxng

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

MCP SearxNG Badge

Tools

Search the web with SearXNG

Prompts

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

Usage

via uvx

  1. configure your client JSON like
{
  "mcpServers": {
    "searxng": {
      "command": "uvx", 
      "args": [
        "mcp-searxng"
      ]
    }
  }
}

via git clone

  1. 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

  1. set the environment variable SEARXNG_URL to the URL of the searxng server (default is http://localhost:8080)

  2. 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