An MCP server for connecting agentic systems to search systems via searXNG.
An MCP server for connecting agentic systems to search systems via searXNG.
Search the web with SearXNG
search(query: str) -> f"Searching for {query} using searXNG"1) configure your client JSON like
{
"mcpServers": {
"searxng": {
"command": "uvx",
"args": [
"mcp-searxng"
]
}
}
}1) 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
2) set the environment variable SEARXNG_URL to the URL of the searxng server (default is http://localhost:8080)
3) 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
[
{
"description": "search the web using searXNG. This will aggregate the results from google, bing, brave, duckduckgo and many others. Use this to find information on the web. Even if you do not have access to the internet, you can still use this tool to search the web.",
"inputSchema": {
"properties": {
"query": {
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search"
}
]