SearxNG MCP Server

An MCP server implementation that integrates the SearxNG API, providing web search capabilities.

Features

Web Search: General queries, news, articles, with pagination.
Pagination: Control return size and result counts options.

Tools

searxng_web_search
- Execute web searches with pagination
- Inputs:
  - query (string): Search terms
  - count (number, optional): Results per page (default 20)
  - offset (number, optional): Pagination offset (default 0)

Configuration

Setting the SEARXNG_URL

Choose a SearxNG instance from the list of public instances or use your local environment.
Set the SEARXNG_URL environment variable to the instance URL.
The default SEARXNG_URL value is http://localhost:8080.

Usage with Claude Desktop

NPX

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y"
        "<full path to mcp-searxng repo>/"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Docker

Build

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

Use

Add this to your claude_desktop_config.json:

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

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.