SearXNG MCP Server

Version: 0.0.2

Perform privacy-respecting web searches using SearXNG through an MCP server!

This repository is actively maintained - Contributions are welcome!

Supports:

• Privacy-respecting metasearch
• Customizable search parameters (language, time range, categories, engines)
• Safe search levels
• Pagination control
• Basic authentication support
• Random instance selection

<details> <summary><b>Usage:</b></summary>

CLI

Short Flag	Long Flag	Description
-h	--help	See usage
-t	--transport	Transport method: 'stdio', 'http', or 'sse' (default: stdio)
-s	--host	Host address for HTTP transport (default: 0.0.0.0)
-p	--port	Port number for HTTP transport (default: 8000)

Using as an MCP Server:

AI Prompt:

Search for information about artificial intelligence

AI Response:

Search completed successfully. Found 10 results for "artificial intelligence":

1. **What is Artificial Intelligence?**
   URL: https://example.com/ai
   Content: Artificial intelligence (AI) refers to the simulation of human intelligence in machines...

2. **AI Overview**
   URL: https://example.org/ai-overview
   Content: AI encompasses machine learning, deep learning, and more...

</details>

<details> <summary><b>Example:</b></summary>

Use in CLI

searxng-mcp --transport http --host 0.0.0.0 --port 8000

Use with AI

Deploy MCP Server as a Service

docker pull knucklessg1/searxng-mcp:latest

Modify the compose.yml

services:
  searxng-mcp:
    image: knucklessg1/searxng-mcp:latest
    environment:
      - SEARXNG_URL=https://searxng.example.com
      - SEARXNG_USERNAME=user
      - SEARXNG_PASSWORD=pass
      - USE_RANDOM_INSTANCE=false
      - HOST=0.0.0.0
      - PORT=8000
    ports:
      - 8000:8000

Configure mcp.json

{
  "mcpServers": {
    "searxng": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "searxng-mcp",
        "searxng-mcp"
      ],
      "env": {
        "SEARXNG_URL": "https://searxng.example.com",
        "SEARXNG_USERNAME": "user",
        "SEARXNG_PASSWORD": "pass",
        "USE_RANDOM_INSTANCE": "false"
      },
      "timeout": 300000
    }
  }
}

Run as a docker container:

services:
  searxng-mcp:
    image: docker.io/knucklessg1/searxng-mcp:latest
    ports:
      - "8000:8000"
    environment:
      - HOST=0.0.0.0
      - PORT=8000
      - TRANSPORT=http
      - SEARXNG_URL=https://searxng.example.com
      - SEARXNG_USERNAME=user
      - SEARXNG_PASSWORD=pass
      - USE_RANDOM_INSTANCE=false

</details>

<details> <summary><b>Installation Instructions:</b></summary>

Install Python Package

python -m pip install searxng-mcp

uv pip install searxng-mcp

</details>

<details> <summary><b>Repository Owners:</b></summary>

<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />

</details>