MCP-searxng
MCP server for connecting agentic systems to search systems via searXNG
what is MCP-searxng?
MCP-searxng is a server designed to connect agentic systems to search systems using the searXNG framework, enabling efficient web searches.
how to use MCP-searxng?
To use MCP-searxng, configure your client JSON or clone the repository and run the server using the provided commands. Set the environment variable for the searXNG URL if needed.
key features of MCP-searxng?
- Connects agentic systems to search systems seamlessly.
- Utilizes the searXNG framework for web searches.
- Customizable server URL for flexibility.
use cases of MCP-searxng?
- Integrating search capabilities into agentic systems.
- Enabling web searches for automated systems.
- Customizing search environments for specific applications.
FAQ from MCP-searxng?
- What is searXNG?
SearXNG is a metasearch engine that aggregates results from various search engines.
- How do I run the server?
You can run the server using the command
uvx mcp-searxngafter configuring your client JSON.
- Can I customize the search URL?
Yes! You can set the
SEARXNG_URLenvironment variable to your desired URL.
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
