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:

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