Provides integration with SearXNG search engine by connecting to a SearXNG instance specified via the --url parameter
SearXNG MCP Server
A Model Control Protocol (MCP) server for SearXNG, allowing AI assistants to search the web through a SearXNG instance.
Features
Search the web using SearXNG via simple API calls
Get information about available search engines
Configure search parameters including categories, languages, and safe search settings
Related MCP server: drupal-modules-mcp MCP Server
Usage in MCP Configuration
"searxng-mcp-server": {
"command": "uv",
"args": [
"run",
"https://raw.githubusercontent.com/maccam912/searxng-mcp-server/refs/heads/main/server.py",
"--url",
"https://searxng.example.com"
]
}
Docker Usage
You can run this MCP server using Docker:
# Build the Docker image
docker build -t searxng-mcp-server .
# Run the container
# Replace https://searxng.example.com with your actual SearXNG instance URL
docker run -p 8080:8080 searxng-mcp-server
API Tools
Search
def search(query: str, categories: Optional[str] = None, engines: Optional[str] = None,
language: Optional[str] = None, page: int = 1, time_range: Optional[str] = None,
safe_search: int = 1)
Get Available Engines
def get_available_engines()
Local Development
Requirements:
Python 3.11+
uv (Python package manager)
# Install dependencies
uv sync
# Run the server
uv run server.py --url https://searxng.example.com