Skip to main content
Glama
SearXNG Control Plane MCP Server

SearXNG Control Plane MCP Server

by TheNovaNodes

SearXNG Control Plane MCP Server

An Model Context Protocol (MCP) server for managing SearXNG instances, configuration settings, search engine states, API health checking, and container lifecycle.

This repository is part of the TheNovaNodes Antigravity Agent Ecosystem. It provides standard MCP tools to interface securely and reliably with SearXNG, empowering ecosystem agents to inspect settings, toggle search engines dynamically, and monitor service health.

Features

  • Inspect Settings: Read and parse SearXNG configuration settings (settings.yml), listing active/disabled engines and configuration parameters.

  • Enable/Disable Search Engines: Toggle individual search engines on or off directly within settings.yml.

  • Health Testing: Test search API health by sending query requests and verifying HTTP response codes, latency, and JSON result payloads.

  • Container Control: Restart the SearXNG Docker container (searxng-app) via subprocess.

Related MCP server: SearXNG MCP Server

Configuration

Environment variables can be used to override default settings:

Variable

Default Value

Description

SEARXNG_SETTINGS_PATH

/home/ddoctorm/services/searxng/settings.yml

Path to SearXNG settings.yml file

SEARXNG_URL

http://localhost:8081

Base URL of SearXNG instance

SEARXNG_CONTAINER_NAME

searxng-app

Name of the Docker container running SearXNG

Installation & Setup

pip install -e .

Available MCP Tools

  • inspect_settings: Inspect current SearXNG configuration settings and list enabled/disabled search engines.

  • enable_engine: Enable a specific search engine in settings.yml.

  • disable_engine: Disable a specific search engine in settings.yml.

  • set_engine_status: Set explicit enabled/disabled state for a search engine in settings.yml.

  • test_search_api_health: Perform a health check query against the SearXNG search endpoint.

  • restart_searxng_container: Restart the SearXNG Docker container via subprocess.

Ecosystem Context

As a part of the TheNovaNodes ecosystem, this project adheres to high-quality standards and ensures robustness for integrations with other Antigravity agents.

License

MIT

Available Tools

6 tools
disable_engineB

Disable a specific search engine in SearXNG settings.yml.

Args: engine_name: Name of the engine to disable (e.g. 'duckduckgo'). settings_path: Optional path to settings.yml.

Inputs: engine_name (required), settings_path. Returns: result

enable_engineB

Enable a specific search engine in SearXNG settings.yml.

Args: engine_name: Name of the engine to enable (e.g. 'duckduckgo'). settings_path: Optional path to settings.yml.

Inputs: engine_name (required), settings_path. Returns: result

inspect_settingsA

Inspect SearXNG configuration settings and active/disabled engines from settings.yml.

Args: settings_path: Optional path to settings.yml. Defaults to SEARXNG_SETTINGS_PATH.

Inputs: settings_path. Returns: result

restart_searxng_containerA

Restart the SearXNG Docker container via subprocess.

Args: container_name: Name of the docker container (defaults to SEARXNG_CONTAINER_NAME).

Inputs: container_name. Returns: result

set_engine_statusA

Enable or disable a search engine in settings.yml.

Args: engine_name: Name of the engine (e.g. 'google cse', 'duckduckgo', 'bing'). enabled: True to enable the engine, False to disable it. settings_path: Optional path to settings.yml. Defaults to SEARXNG_SETTINGS_PATH.

Inputs: enabled (required), engine_name (required), settings_path. Returns: result

test_search_api_healthA

Test SearXNG Search API health by issuing a test query and measuring latency.

Args: url: Base URL or search endpoint of SearXNG instance (defaults to SEARXNG_URL). query: Test search query string (defaults to 'healthcheck').

Inputs: url, query. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 6 tools

    Disambiguation2/5

    The three engine control tools (set_engine_status, enable_engine, disable_engine) heavily overlap, with set_engine_status effectively combining the other two. This creates ambiguity about which tool to use for enabling/disabling an engine. The remaining tools are distinct but the redundancy lowers the overall clarity.

    Naming Consistency4/5

    All tool names follow a consistent verb_noun pattern with snake_case (inspect_settings, set_engine_status, enable_engine, disable_engine, test_search_api_health, restart_searxng_container). The only inconsistency is that set_engine_status and enable/disable_engine represent overlapping actions, but the naming convention itself is uniform.

    Tool Count5/5

    With six tools, the server is well-scoped for a control plane managing a SearXNG instance. Each tool covers a distinct area (settings inspection, engine status modification, health testing, container restart) without unnecessary bloat, making the count appropriate.

    Completeness3/5

    The surface covers core operations like inspecting settings, toggling engines, testing health, and restarting. However, it lacks lifecycle operations such as starting, stopping, or getting the container status, and there's no direct 'apply config' action. These gaps are notable for a control plane but not fatal.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that allows searching through public SearXNG instances by parsing HTML content into JSON results, enabling metasearch capabilities without requiring JSON API access.
      1
      73 npm
      57
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Self-contained SearXNG MCP server in Docker. Aggregates 200+ search engines across 30+ categories with multi-page fanout, autocomplete, and engine discovery. Dual transport (HTTP + stdio), API key auth, and built-in Web UI reverse proxy.
      3
      11
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that integrates the SearXNG API for web search and URL content extraction with advanced features like pagination, caching, and proxy support.
      4
      17,815 npm
      2
      MIT