SearXNG MCP Server

PyPI - Version PyPI - Downloads GitHub Repo stars GitHub forks GitHub contributors PyPI - License GitHub

GitHub last commit (by committer) GitHub pull requests GitHub closed pull requests GitHub issues

GitHub top language GitHub language count GitHub repo size GitHub repo file count (file type) PyPI - Wheel PyPI - Implementation

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

Usage:

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...

Example:

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

Installation Instructions:

Install Python Package

python -m pip install searxng-mcp

uv pip install searxng-mcp

Repository Owners:

GitHub followers GitHub User's stars

SearXNG MCP Server