SearXNG MCP by SecretiveShell
SecretiveShellLABSCO SUMMARY
Which search index it uses is your decision, and so is where the queries go.
Point SEARXNG_MCP_SEARXNG_URL at your own SearxNG instance and searches never leave your infrastructure; point it at a public instance from searx.space and you are running with no key at all. One setting to leave alone: log levels above ERROR write into the same channel the client reads.
What it is
A deliberately minimal MCP search server. It queries SearxNG, a privacy-respecting metasearch engine, and returns results formatted for a language model to read.
What you get
- Web search through any SearxNG instance, self-hosted or public
- Clean, formatted results built to keep context-window use low
- Defaults you set: result count, language, and text or json output
- Stdio for desktop clients, or SSE over HTTP on port 8000
- No installation needed — pipx run searxng-simple-mcp@latest, uvx, or the ghcr.io/sacode/searxng-simple-mcp image
Requirements
Python 3.10 or higher and a SearxNG instance. SEARXNG_MCP_SEARXNG_URL points at it; SEARXNG_MCP_TIMEOUT defaults to 10 seconds and SEARXNG_MCP_DEFAULT_RESULT_COUNT to 10. No API key is involved. Version 1.2.0.
Setup effort
One command — pipx run searxng-simple-mcp
USE CASES
01
Giving an assistant current web results
Ask a question that needs today's web and get formatted results back.
02
Keeping searches inside your own network
Point the server at your self-hosted SearxNG instance instead of a public one.
03
Searching without spending the context window
Trim the default result count and language so each search costs less to read.
BEFORE YOU INSTALL
What to know first
Requires
- pipx on PATH
- Python 3.10 or later
- A SearxNG instance, public or self-hosted
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pipx run searxng-simple-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"searxng": {
"command": "pipx",
"args": [
"run",
"searxng-simple-mcp@latest"
],
"env": {
"SEARXNG_MCP_SEARXNG_URL": "<YOUR_SEARXNG_MCP_SEARXNG_URL>"
}
}
}
}<YOUR_SEARXNG_MCP_SEARXNG_URL> is the address of the SearxNG instance to search through. Your own, or a public one from https://searx.space. If you leave the variable out, the server uses https://paulgo.io/.
