SearXNG Meta Search

by kevinwatt

13 stars
5.8k downloads
Not rated
GitHub

About

Integrates SearXNG's meta-search capabilities to provide privacy-focused, customizable search results from multiple engines for diverse information retrieval scenarios.

Details

Author
kevinwatt
Repository
kevinwatt/mcp-server-searxng
GitHub stars
13
Downloads
5,812
License
MIT License
Categories
Productivity, Developer Tools, Design, AI, Search, Knowledge Base, Infrastructure, Frontend, Other
Tags
#mobile

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name SearXNG Meta Search
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @kevinwatt/mcp-server-searxng
    Environment
    • SEARXNG_INSTANCES http://localhost:8080,https://searx.example.com
    • SEARXNG_USER_AGENT CustomBot/1.0
    • NODE_TLS_REJECT_UNAUTHORIZED 0

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


To install SearXNG MCP Server for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @kevinwatt/mcp-server-searxng --client claude

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

mkdir -p searxng

tee searxng/settings.yml << EOF
use_default_settings: true

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']), time_range (string, optional): Time filter (day/week/month/year), safesearch (number, optional): Safe search level (0: None, 1: Moderate, 2: Strict, default: 1)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "searxng meta search": {
            "env": {
                "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
                "SEARXNG_USER_AGENT": "CustomBot/1.0",
                "NODE_TLS_REJECT_UNAUTHORIZED": "0"
            },
            "args": [
                "-y",
                "@kevinwatt/mcp-server-searxng"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
    },
    "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
    },
    "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@kevinwatt/mcp-server-searxng"
    ],
    "command": "cmd"
}

SearXNG MCP Server

smithery badge

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

Installing via Smithery

To install SearXNG MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kevinwatt/mcp-server-searxng --client claude

Manual 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

```bash

Create config directory


mkdir -p searxng

Create config file

tee searxng/settings.yml << EOF use_default_settings: true
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.