SearXNG MCP Server

Features

• **Zero-configuration setup**: Works immediately by using a random public instance from [SearX.space](https://searx.space/)

• **Private instance support**: Connect to your own SearXNG instance with optional basic authentication

• Perform web searches with customizable parameters

• Support for multiple search engines

• Privacy-focused search results

• Markdown-formatted search results

• Sensible default values for all parameters

Installation

Prerequisites

• Node.js (v16 or higher)

• npm (v7 or higher)

• Access to a SearXNG instance (self-hosted or public)

Install from source

Configuration

• `SEARXNG_URL` (optional): The URL of your SearXNG instance (e.g., `https://searx.example.com`). If not provided, a random public instance from [SearX.space](https://searx.space/) will be automatically selected, making the server usable with zero additional deployment.

• `USE_RANDOM_INSTANCE` (optional): Set to "false" to disable random instance selection when no URL is provided. Default is "true".

• `SEARXNG_USERNAME` (optional): Username for basic authentication when connecting to a private instance

• `SEARXNG_PASSWORD` (optional): Password for basic authentication when connecting to a private instance

Usage

Running the server

Integrating with Claude Desktop

1. Open Claude Desktop

2. Go to Settings > MCP Servers

3. Add a new MCP server with the following configuration: ```json { "mcpServers": { "searxngmcp": { "command": "searxngmcp", "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } } ```

Integrating with Claude in VSCode

1. Open VSCode

2. Go to Settings > Extensions > Claude > MCP Settings

3. Add a new MCP server with the following configuration: ```json { "mcpServers": { "searxngmcp": { "command": "node", "args": ["/path/to/searxng-mcp/build/index.js"], "env": { // Optional: If not provided, a random public instance will be used "SEARXNG_URL": "https://searx.example.com", // Optional: Only needed for private instances with authentication "SEARXNG_USERNAME": "your_username", "SEARXNG_PASSWORD": "your_password" }, "disabled": false, "autoApprove": [] } } } ```

Usage with Smolagents

Available Tools

searxngsearch

Parameters

Example

Development

Setup

Build

Watch mode (for development)

Testing with MCP Inspector

License