searxng-mcp-server

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

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