SearXNG MCP Server

PyPI - Version PyPI - Downloads GitHub Repo stars GitHub forks GitHub contributors PyPI - License GitHub

GitHub last commit (by committer) GitHub pull requests GitHub closed pull requests GitHub issues

GitHub top language GitHub language count GitHub repo size GitHub repo file count (file type) PyPI - Wheel PyPI - Implementation

Version: 0.0.2

Perform privacy-respecting web searches using SearXNG through an MCP server!

This repository is actively maintained - Contributions are welcome!

Supports:

Privacy-respecting metasearch
Customizable search parameters (language, time range, categories, engines)
Safe search levels
Pagination control
Basic authentication support
Random instance selection

CLI

Short Flag	Long Flag	Description
-h	--help	See usage
-t	--transport	Transport method: 'stdio', 'http', or 'sse' (default: stdio)
-s	--host	Host address for HTTP transport (default: 0.0.0.0)
-p	--port	Port number for HTTP transport (default: 8000)

Using as an MCP Server:

AI Prompt:

Search for information about artificial intelligence

AI Response:

Search completed successfully. Found 10 results for "artificial intelligence": 1. **What is Artificial Intelligence?** URL: https://example.com/ai Content: Artificial intelligence (AI) refers to the simulation of human intelligence in machines... 2. **AI Overview** URL: https://example.org/ai-overview Content: AI encompasses machine learning, deep learning, and more...

Use in CLI

searxng-mcp --transport http --host 0.0.0.0 --port 8000

Use with AI

Deploy MCP Server as a Service

docker pull knucklessg1/searxng-mcp:latest

Modify the compose.yml

services: searxng-mcp: image: knucklessg1/searxng-mcp:latest environment: - SEARXNG_URL=https://searxng.example.com - SEARXNG_USERNAME=user - SEARXNG_PASSWORD=pass - USE_RANDOM_INSTANCE=false - HOST=0.0.0.0 - PORT=8000 ports: - 8000:8000

Configure mcp.json

{ "mcpServers": { "searxng": { "command": "uv", "args": [ "run", "--with", "searxng-mcp", "searxng-mcp" ], "env": { "SEARXNG_URL": "https://searxng.example.com", "SEARXNG_USERNAME": "user", "SEARXNG_PASSWORD": "pass", "USE_RANDOM_INSTANCE": "false" }, "timeout": 300000 } } }

Run as a docker container:

services: searxng-mcp: image: docker.io/knucklessg1/searxng-mcp:latest ports: - "8000:8000" environment: - HOST=0.0.0.0 - PORT=8000 - TRANSPORT=http - SEARXNG_URL=https://searxng.example.com - SEARXNG_USERNAME=user - SEARXNG_PASSWORD=pass - USE_RANDOM_INSTANCE=false

Install Python Package

python -m pip install searxng-mcp

uv pip install searxng-mcp

GitHub followers GitHub User's stars

Deploy Server

HTTP connection URL

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

web_search

Enables privacy-respecting web searches through SearXNG metasearch engine with customizable parameters like language, time range, categories, and engines. Supports safe search levels, pagination control, and basic authentication for secure search operations.

SearXNG MCP Server

SearXNG MCP Server

Supports:

CLI

Using as an MCP Server:

Use in CLI

Use with AI

Tools

New MCP Servers

MCP directory API