SearXNG MCP Server

An MCP server implementation that integrates with SearXNG, providing privacy-focused meta search capabilities.

Features

• Meta Search: Combines results from multiple search engines
• Privacy-Focused: No tracking, no user profiling
• Multiple Categories: Support for general, news, science, files, images, videos, and more
• Language Support: Search in specific languages or all languages
• Time Range Filtering: Filter results by day, week, month, or year
• Safe Search: Three levels of safe search filtering
• Fallback Support: Multiple SearXNG instances for reliability

Installation

npm install -g @kevinwatt/mcp-server-searxng

Usage

Direct Run

mcp-server-searxng

With Dive Desktop

1. Click "+ Add MCP Server" in Dive Desktop
2. Copy and paste this configuration:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

3. Click "Save" to install the MCP server

Tool Documentation

• web_search
  • Execute meta searches across multiple engines
  • Inputs:
    • query (string): Search terms
    • page (number, optional): Page number (default: 1)
    • language (string, optional): Language code (e.g., 'en', 'all', default: 'all')
    • categories (array, optional): Search categories (default: ['general'])
      • Available: "general", "news", "science", "files", "images", "videos", "music", "social media", "it"
    • time_range (string, optional): Time filter (day/week/month/year)
    • safesearch (number, optional): Safe search level (0: None, 1: Moderate, 2: Strict, default: 1)

Development

git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start

License

            This MCP server is licensed under the MIT License. See the LICENSE file for details.

Prerequisites

You need a local SearXNG instance running. To set it up:

Run SearXNG with Docker

Quick Start

# Create config directory
mkdir -p searxng

# Create config file
tee searxng/settings.yml 
        
            
                - `NODE_TLS_REJECT_UNAUTHORIZED`: Set to '0' to bypass SSL certificate verification (for development with self-signed certificates)
  Default: undefined (SSL verification enabled)

Example configuration with all options:
```json
{
  "mcpServers": {
    "searxng": {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ],
      "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

⚠️ Warning: Disabling SSL certificate verification is not recommended in production environments.