SearXNG

searxng-mcp-server

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "martinchen448-searxng-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "searxng_mcp_server"
      ],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080/",
        "SEARXNG_VERIFY_SSL": "false"
      }
    }
  }
}

You have a Model Context Protocol (MCP) server that bridges MCP clients to a SearXNG instance. It lets you perform web searches, get autocomplete suggestions, check health, and retrieve configuration capabilities from your SearXNG setup through MCP-aware applications. This guide walks you through using, installing, and configuring the server so you can search efficiently across engines and categories with safe, localized queries.

How to use

Use the MCP server to issue web search requests through your MCP client. You can search across multiple engines, filter by category (general, images, news, etc.), limit results by language and time, and request safer results. You can also fetch search suggestions and inspect the server’s health and configuration capabilities to tailor your setup.

How to install

Prerequisites: you need Python 3.10 or higher and a running SearXNG instance. Ensure your MCP client is ready to connect to an MCP server, such as Claude Desktop or Cline.

# 1) Clone the MCP server repository
git clone https://github.com/martinchen448/searxng-mcp-server.git
cd searxng-mcp-server

# 2) Install the package in editable mode
pip install -e .

If you prefer installing from PyPI when available, you would run the package manager command below once the package is published:
- pip install searxng-mcp-server

Configuration and usage notes

For local development and testing, you run the MCP server as a Python module. Configure the MCP entry in your client to point to the local Python process that serves MCP requests.

Environment and run configuration

The server runs with environment variables that point to your SearXNG instance. Use a local or public SearXNG URL and control SSL verification as needed.

Troubleshooting and testing

If you encounter connection issues, verify the SearXNG URL, check SSL verification settings, test the instance directly in a browser, and inspect logs for errors.

Notes on environment variables

Common environment variables you set when starting the MCP server include SEARXNG_BASE_URL for the SearXNG endpoint and SEARXNG_VERIFY_SSL to toggle SSL certificate verification. Use false for self-signed certificates or local development.

Health checks and capabilities

You can query the MCP server to perform health checks and to retrieve the SearXNG configuration and capabilities, such as available engines, enabled categories, and supported languages, to tailor your queries.

Installation and run examples

The following commands illustrate a typical local run setup. Use the exact commands in your environment to start the MCP server.

Available tools

search

Perform web searches across multiple search engines with optional category, language, time range, and safesearch controls.

get_suggestions

Get autocomplete suggestions for a query prefix to help with search term completion.

health_check

Check if the connected SearXNG instance is accessible and healthy.

get_config

Retrieve the configuration and capabilities of the SearXNG instance, including engines, languages, and plugins.