================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
MCP-searxng
by SecretiveShell
MCP server that exposes a SearXNG web-search tool to MCP/agentic clients.
85
14
Open Source01
search
Search the web with SearXNG
Installation
1. Prerequisites
• Python ≥3.9
• git
• (optional) running SearXNG instance or URL of any public instance.
2. Clone repository
git clone https://github.com/SecretiveShell/MCP-searxng.git
cd MCP-searxng
3. Create isolated environment (recommended)
python3 -m venv .venv
source .venv/bin/activate
4. Install Python dependencies
pip install -r requirements.txt
5. Configure server
• Copy example configuration: cp config.example.yaml config.yaml
• Edit config.yaml and set:
searxng_url: "https://your-searxng-instance.example" # or public instance
api_key: "<a-long-random-token>" # token your agents will send in HTTP header `x-api-key`
listen_host: 0.0.0.0
listen_port: 8080
Alternatively use environment variables:
export SEARXNG_URL="https://your-searxng-instance.example"
export MCP_SEARCH_API_KEY="<token>"
export MCP_PORT=8080
6. Run development server
python -m mcp_searxng
7. Production example (systemd)
[Unit]
Description=MCP-searxng
After=network.target
[Service]
WorkingDirectory=/opt/MCP-searxng
ExecStart=/opt/MCP-searxng/.venv/bin/python -m mcp_searxng
Environment="SEARXNG_URL=https://your-searxng-instance.example"
Environment="MCP_SEARCH_API_KEY=<token>"
Restart=always
[Install]
WantedBy=multi-user.target
Documentation
License: MIT License
Updated 7/30/2025