Searxng MCP Server

🚀 SearXNG MCP Server

The SearXNG MCP Server is a powerful tool that integrates with SearXNG, providing extended functionality and flexible configuration options.

🚀 Quick Start

✨ Features

• Support for both Docker and local installation methods.
• Customizable configuration parameters for network, SearXNG, and logging.
• Easy integration with clients such as Windsurf and n8n.
• Allows for custom server extensions, including adding custom tools and configuring lifecycle functions.

📦 Installation

Environment Requirements

• Python 3.8 or higher.
• Docker (optional).

Installation Methods

1. Install using Docker:

   docker run -d --name searxng-mcp-server -p 32769:32769 mcp/searxng-mcp-server
   

2. Local Installation:

   git clone https://github.com/your-repository.git
   cd searxng-mcp-server
   pip install -r requirements.txt
   python server.py
   

📚 Documentation

Configuration Parameters

Network Configuration

• HOST: The address to which the server binds, default is 0.0.0.0.
• PORT: The port on which the server listens, default is 32769.

SearXNG Configuration

• SEARXNG_BASE_URL: The base URL of SearXNG, e.g., http://localhost:32768.

Logging Configuration

• LOG_LEVEL: The logging level, available values are debug, info, warning, error, critical, default is info.
• LOG_FILE: The path to the log file, default is ./mcp_server.log.

Integration with Clients

Configuration with Windsurf

Add the following content to your configuration file:

{
  "mcpServers": {
    "searxng": {
      "transport": "sse",
      "serverUrl": "http://host.docker.internal:32769/sse"
    }
  }
}

Configuration with n8n

Set the following in your node configuration:

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-e", "TRANSPORT=stdio",
               "-e", "SEARXNG_BASE_URL=http://localhost:32768",
               "mcp/searxng-mcp-server"],
      "env": {
        "PORT": "32769"
      }
    }
  }
}

Custom Server Extensions

Adding Custom Tools

Create custom tool methods using the @mcp.tool() decorator.

Configuring Lifecycle Functions

Add the following to server.py:

def lifespan(app: FastAPI):
    # Initialize database connections or other dependencies
    return {"startup": None, "shutdown": None}

SearXNG Search Parameters

• q: Required, the search query string.
• categories: The active search categories, separated by commas.
• engines: The active search engines, separated by commas.
• For other advanced parameters such as language and number of pages, please refer to SearXNG Documentation.

📄 License

This project is licensed under the MIT License.