Searxng Mul Mcp

by jae-jae

320 downloads

Not rated

GitHub

Other

About

A Model Context Protocol (MCP) server for SearXNG search engine with multi-query parallel search support

Details

Author: jae-jae
Downloads: 320
Categories: Other

- Multi-query parallel search for improved efficiency
- Dual transport support (stdio and HTTP)
- Direct SearXNG REST API integration without browser automation
- Basic Authentication support for secured SearXNG instances
- Docker deployment with Docker and Docker Compose
- Environment-based configuration and structured logging

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Searxng Mul Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

From the repository

You can run it directly via npx (e.g., SEARXNG_URL=https://your.searxng.com npx -y searxng-mul-mcp) or deploy with Docker. Configure via environment variables: SEARXNG_URL (required), optional USERNAME/PASSWORD for Basic Auth, TRANSPORT, HOST, PORT. For HTTP mode, add --transport=http --host=0.0.0.0 --port=3000. Integrate with Claude Desktop by adding a mcpServers entry in claude_desktop_config.json. Install from source with npm install && npm run build && npm start.

`search`

Search multiple queries simultaneously using SearXNG metasearch engine. Supports parallel execution of multiple search queries with optional engine and category filtering.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "searxng mul mcp": {
            "searxng-mul-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "searxng-mul-mcp"
                ],
                "env": {
                    "SEARXNG_URL": "https://your.searxng.com",
                    "USERNAME": "your_username",
                    "PASSWORD": "your_password"
                }
            }
        }
    }
}

McpServers

{
    "searxng-mul-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "searxng-mul-mcp"
        ],
        "env": {
            "SEARXNG_URL": "https://your.searxng.com",
            "USERNAME": "your_username",
            "PASSWORD": "your_password"
        }
    }
}

SearXNG MCP Server

A Model Context Protocol (MCP) server for SearXNG metasearch engine integration, supporting multi-query parallel search with both stdio and HTTP transport protocols.

> 🌟 Recommended: OllaMan - Powerful Ollama AI Model Manager.

Features

- ✅ Multi-Query Parallel Search: Execute multiple search queries simultaneously for improved efficiency
- ✅ Dual Transport Support: Compatible with both stdio and HTTP MCP transport protocols
- ✅ SearXNG API Integration: Direct integration with SearXNG REST API without browser automation
- ✅ Basic Authentication: Support for SearXNG servers with Basic Auth protection
- ✅ Docker Deployment: Complete containerization with Docker and Docker Compose
- ✅ Environment Configuration: Flexible configuration management through environment variables

Quick Start

NPM Usage

Stdio Mode (Default)

bash

SEARXNG_URL=https://your.searxng.com npx -y searxng-mul-mcp





HTTP Mode

bash

SEARXNG_URL=https://your.searxng.com npx -y searxng-mul-mcp --transport=http --host=0.0.0.0 --port=3000





Environment Variables

bash

Required: SearXNG server URL



SEARXNG_URL=https://your.searxng.com



Optional: Basic Auth credentials



USERNAME=your_username

PASSWORD=your_password



Optional: Transport configuration (can also use CLI flags)



TRANSPORT=stdio|http

HOST=0.0.0.0        # HTTP mode only

PORT=3000           # HTTP mode only



Optional: Debug mode



DEBUG=false





Configuration






Claude Desktop Configuration






Add the following configuration to your Claude Desktop

claude_desktop_config.json

 file:



stdio mode:

json

{

  "mcpServers": {

    "searxng-mul-mcp": {

      "command": "npx",

      "args": ["-y", "searxng-mul-mcp"],

      "env": {

        "SEARXNG_URL": "https://your.searxng.com",

        "USERNAME": "your_username",

        "PASSWORD": "your_password"

      }

    }

  }

}





SearXNG Server Setup






This MCP server requires access to a SearXNG instance. You can:



1. Use a public SearXNG instance (like

https://your.searxng.com

)

2. Deploy your own SearXNG server

3. Use a private SearXNG instance with Basic Auth



Basic Authentication






If your SearXNG server requires Basic Auth:

bash

export USERNAME=your_username

export PASSWORD=your_password





Transport Protocols






Stdio Transport






- Default mode for MCP client integration

- Uses standard input/output for communication

- Suitable for direct MCP client connections



HTTP Transport






- Provides StreamableHTTP JSON-RPC interface (protocol version 2025-03-26)

- Includes health check endpoint at

/health



- MCP endpoint at

/mcp

 for client communication

- Supports session management with automatic cleanup

- Full CORS support for cross-origin requests

- Suitable for web-based integrations and modern MCP clients





Installation






From Source

bash

git clone <repository-url>

cd searxng-mul-mcp

npm install

npm run build

npm start





Docker Deployment






Create a

docker-compose.yml

 file:

yaml

services:

  searxng-mul-mcp:

    image: ghcr.io/jae-jae/searxng-mul-mcp:latest

    environment:

      - SEARXNG_URL=https://your.searxng.com

      # Optional: Basic Auth

      # - USERNAME=your_username

      # - PASSWORD=your_password

    ports:

      - "3000:3000"





Run with:

bash

docker-compose up -d





MCP Tool Usage






The server provides a single

 tool that accepts the following parameters:



Parameters






- queries (required): Array of search query strings to execute in parallel

- engines (optional): Specific search engines to use (e.g., "google", "bing", "duckduckgo")

- categories (optional): Search categories to filter results (e.g., "general", "images", "news")

- safesearch (optional): Safe search level (0=off, 1=moderate, 2=strict)

- language (optional): Search language code (e.g., "en", "zh", "es")





Development






Prerequisites






- Node.js 18 or higher

- npm or yarn

- TypeScript



Build Commands

bash

Install dependencies



npm install



Build TypeScript



npm run build



Start development server



npm run dev



Run in production



npm start



Clean build directory



npm run clean



Run tests



npm test



Lint code



npm run lint



Format code



npm run format





Project Structure



searxng-mul-mcp/

├── src/

│   ├── index.ts                 # Application entry point

│   ├── server.ts               # MCP server core logic

│   ├── config/

│   │   └── index.ts            # Configuration management

│   ├── tools/

│   │   ├── index.ts            # Tool definitions

│   │   └── searxng.ts          # SearXNG search tool implementation

│   ├── transports/

│   │   ├── index.ts            # Transport factory

│   │   ├── stdio.ts            # Stdio transport implementation

│   │   ├── http.ts             # HTTP transport implementation

│   │   └── types.ts            # Transport type definitions

│   ├── services/

│   │   └── searxng-api.ts      # SearXNG API client

│   └── utils/

│       └── logger.ts           # Logging utilities

├── build/                      # TypeScript compilation output

├── package.json               # Project dependencies and scripts

├── tsconfig.json              # TypeScript configuration

├── Dockerfile                 # Docker image build

├── docker-compose.yml         # Docker Compose configuration

└── README.md                  # This file





API Reference






SearXNG API Integration






This server integrates with the SearXNG search API. For more information about SearXNG API capabilities, see: https://docs.searxng.org/dev/search_api.html



Error Handling






The server implements comprehensive error handling:



- Network errors: Automatic retry mechanism (up to 3 attempts)

- Authentication errors: Clear error messages for auth failures

- API rate limiting: Graceful degradation and error reporting

- Timeout handling: Configurable request timeout (default: 30 seconds)



Monitoring






Health Checks






HTTP mode provides a health check endpoint:

bash

curl http://localhost:3000/health





Response:

json

{

  "status": "healthy",

  "timestamp": "2024-01-01T00:00:00.000Z",

  "version": "1.0.0"

}





Logging






The server provides structured logging with configurable levels:



- ERROR: Critical errors and failures

- WARN: Warning messages and degraded functionality

- INFO: General operational information

- DEBUG: Detailed debugging information (enable with

DEBUG=true

)



Troubleshooting






Common Issues






1. Connection Failed: Check your

SEARXNG_URL

 and network connectivity

2. Authentication Error: Verify

USERNAME and PASSWORD

 for Basic Auth

3. Port Already in Use: Change the

PORT

 environment variable for HTTP mode

4. Search Timeout: Increase timeout or check SearXNG server performance



Debug Mode






Enable debug logging for detailed troubleshooting:

bash

DEBUG=true npx searxng-mul-mcp

License

MIT License - see LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Support

For issues and questions:

1. Check the troubleshooting section
2. Review SearXNG documentation
3. Open an issue on GitHub

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search

Claude Desktop / Cursor

McpServers

SearXNG MCP Server

Features

Quick Start

NPM Usage

Stdio Mode (Default)

HTTP Mode

Environment Variables

Required: SearXNG server URL

Optional: Basic Auth credentials

Optional: Transport configuration (can also use CLI flags)

Optional: Debug mode

Configuration

Claude Desktop Configuration

SearXNG Server Setup

Basic Authentication

Transport Protocols

Stdio Transport

HTTP Transport

Installation

From Source

Docker Deployment

MCP Tool Usage

Parameters

Development

Prerequisites

Build Commands

Install dependencies

Build TypeScript

Start development server

Run in production

Clean build directory

Run tests

Lint code

Format code

Project Structure

API Reference

SearXNG API Integration

Error Handling

Monitoring

Health Checks

Logging

Troubleshooting

Common Issues

Debug Mode

License

Contributing

Support

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`search`