Kevinwatt MCP Server Searxng

🚀 SearXNG MCP Server

An MCP server implementation integrated with SearXNG, offering privacy-focused meta-search functionality.

🚀 Quick Start

This is an MCP server implementation integrated with SearXNG, providing privacy - focused meta - search functionality.

✨ Features

• Meta - search: Combines results from multiple search engines.
• Privacy - focused: No tracking, no user profiling.
• Multi - category support: General, news, science, files, images, videos, etc.
• Language support: Specify a language or all languages.
• Time range filtering: Filter results by day, week, month, or year.
• Safe search: Three levels of safe search filtering (None, Medium, Strict).
• Backup support: Multiple SearXNG instances ensure reliability.

📦 Installation

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

💻 Usage Examples

Basic Usage

mcp-server-searxng

Advanced Usage

Use in combination with Dive Desktop

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

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

3. Click "Save" to install the MCP server.

📚 Documentation

web_search

• Performs a meta - search across multiple engines.
• Input:
  • query (string): Search term.
  • 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 values: "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: Medium, 2: Strict, default: 1).

🔧 Technical Details

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. For more details, see the LICENSE file.

Prerequisites

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

Run SearXNG with Docker

Quick Start

# Create the configuration directory
mkdir -p searxng

# Create the configuration file
tee searxng/settings.yml << EOF
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE"  # Generate a random key
  port: 8080

search:
  safe_search: 0
  formats:
    - html
    - json

engines:
  - name: google
    engine: google
    shortcut: g

  - name: duckduckgo
    engine: duckduckgo
    shortcut: d

  - name: bing
    engine: bing
    shortcut: b

server.limiter: false
EOF

# Start the container
docker run -d \
  --name searxng \
  -p 8080:8080 \
  -v $(pwd)/searxng:/etc/searxng \
  searxng/searx:latest

Configuration File Explanation

• use_default_settings: true: Use default settings, no additional configuration required.
• bind_address: "0.0.0.0": Allow external access.
• secret_key: Used for API authentication, please replace with a random string.
• port: 8080: Specify the port.

Environment Variables

docker run -d \
  --name searxng \
  -p 8080:8080 \
  -e SEARXNG_BEANSTALKD=redis://beanstalkd:1327 \
  -v $(pwd)/searxng:/etc/searxng \
  searxng/searx:latest

Multi - Instance Support

Configure multiple SearXNG instances in the MCP server:

{
    "mcpServers": {
        "searxng": {
            "name": "searxng",
            "command": "npx",
            "args": [
                "-y",