SecretiveShell/MCP-searxng
🐍 🏠 - An MCP Server to connect to searXNG instances
Quick Install
{
"mcpServers": {
"secretiveshell-mcp-searxng": {
"command": "npx",
"args": [
"-y",
"secretiveshell-mcp-searxng"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
MCP-searxng
An MCP server for connecting agentic systems to search systems via searXNG.
Tools
Search the web with SearXNG
Prompts
search(query: str) -> f"Searching for {query} using searXNG"
Usage
via uvx
- configure your client JSON like
{
"mcpServers": {
"searxng": {
"command": "uvx",
"args": [
"mcp-searxng"
]
}
}
}
via git clone
- Add the server to claude desktop (the entrypoint is main.py)
Clone the repo and add this JSON to claude desktop
you can run this server with uvx mcp-searxng, or use a local copy of the repo
{
"mcpServers": {
"searxng": {
"command": "uv",
"args": [
"--project",
"/absoloute/path/to/MCP-searxng/",
"run",
"/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
]
}
}
}
you will need to change the paths to match your environment
Custom SearXNG URL
-
set the environment variable
SEARXNG_URLto the URL of the searxng server (default ishttp://localhost:8080) -
run your MCP client and you should be able to search the web with searxng
Note: if you are using claude desktop make sure to kill the process (task manager or equivalent) before running the server again