searXNG

A network search server based on MCP technology, providing privacy-friendly web search functionality using the SearXNG search engine.

Features

This server provides the following main features:

• Web search via multiple search engines
• Supports various search categories (general, images, news, etc.)
• Customizable search engine selection
• Language filtering
• Time range filtering
• Control over the number of search results

Available Tools

• web_search - Perform web search using SearXNG
  • Required parameters:
    • query (string): The search query
  • Optional parameters:
    • categories (array): Search categories, e.g. ['general', 'images', 'news']
    • engines (array): Search engines, e.g. ['google', 'bing', 'duckduckgo']
    • language (string): Language code for search, default is "en"
    • max_results (integer): Maximum number of results, default is 10
    • time_range (string): Time range filter ('day', 'week', 'month', 'year')

Usage Example

Configure as an MCP Service

To set up SearXNG as an MCP server, add one of the following to your MCP configuration file:

UVX setup:

"mcpServers": {
  "searxng": {
    "command": "uvx",
    "args": ["searxng", "--instance-url=https://searx.party"]
  }
}

Docker setup:

"mcpServers": {
  "searxng": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "supercorp/supergateway:uvx",
      "--stdio",
      "uvx searxng --instance-url=https://searx.party"
    ]
  }
}

Example Invocation

{
  "name": "web_search",
  "arguments": {
    "query": "climate change research",
    "categories": ["general"],
    "engines": ["google"],
    "language": "en",
    "max_results": 15,
    "time_range": "month"
  }
}

Debugging

You can use the MCP inspector to debug the server:

npx @modelcontextprotocol/inspector uvx searxng

License

AGPLv3+ License - see LICENSE for details.