SearXNG MCP Server

Features

• Web Search: General queries, news, articles, with pagination.
• Pagination: Control which page of results to retrieve.
• Time Filtering: Filter results by time range (day, month, year).
• Language Selection: Filter results by preferred language.
• Safe Search: Control content filtering level for search results.

Tools

• searxng_web_search
  • Execute web searches with pagination
  • Inputs:

    • query

      (string): The search query. This string is passed to external search services.

    • pageno

      (number, optional): Search page number, starts at 1 (default 1)

    • time_range

      (string, optional): Filter results by time range - one of: "day", "month", "year" (default: none)

    • language

      (string, optional): Language code for results (e.g., "en", "fr", "de") or "all" (default: "all")

    • safesearch

      (number, optional): Safe search filter level (0: None, 1: Moderate, 2: Strict) (default: instance setting)
• web_url_read
  • Read and convert the content from a URL to markdown
  • Inputs:

    • url

      (string): The URL to fetch and process

Configuration

Setting the SEARXNG_URL

1. Choose a SearxNG instance from the list of public instances or use your local environment.
2. Set the

   SEARXNG_URL

   environment variable to the instance URL.
3. The default

   SEARXNG_URL

   value is

   http://localhost:8080

   .

Usage with Claude Desktop

Installing via Smithery

npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude

NPX

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

NPM

npm install -g mcp-searxng

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Docker

Using Pre-built Image from Docker Hub

docker pull isokoliuk/mcp-searxng:latest

claude_desktop_config.json

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Build Locally

docker build -t mcp-searxng:latest -f Dockerfile .

Use

claude_desktop_config.json

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

License