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

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

To install SearxNG Server for Claude Desktop automatically 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

And then in your MCP config file:

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

Docker

Build

docker build -t mcp-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-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.