Back to Home
Knuckles-Team icon

searxng-mcp

Verified Safe

by Knuckles-Team

Overview

Provides a Model Context Protocol (MCP) server and an Agent2Agent (A2A) agent for performing privacy-respecting web searches using SearXNG.

Installation

Run Command
docker run -d --name searxng-mcp -p 8004:8004 -e HOST=0.0.0.0 -e PORT=8004 -e TRANSPORT=http -e AUTH_TYPE=none -e EUNOMIA_TYPE=none -e SEARXNG_URL=https://searxng.example.com -e SEARXNG_USERNAME=user -e SEARXNG_PASSWORD=pass -e USE_RANDOM_INSTANCE=false knucklessg1/searxng-mcp:latest

Environment Variables

  • SEARXNG_INSTANCE_URL
  • HOST
  • PORT
  • TRANSPORT
  • SEARXNG_USERNAME
  • SEARXNG_PASSWORD
  • USE_RANDOM_INSTANCE
  • AUTH_TYPE
  • EUNOMIA_TYPE
  • OIDC_CONFIG_URL
  • OIDC_CLIENT_ID
  • OIDC_CLIENT_SECRET

Security Notes

The server uses environment variables for sensitive configurations like API keys and credentials, which is good practice. It leverages `yaml.safe_load` to prevent arbitrary code execution from external YAML files. Authentication mechanisms (JWT, OAuth, OIDC) are provided via the `fastmcp` library, which implies robust security handling. A minor concern is the programmatic setting of `os.environ` for LLM API keys in `searxng_agent.py`, though default values point to local LLM instances (like Ollama) reducing immediate external exposure risk. External instance lists are fetched from GitHub, which is an external dependency but reasonable for its functionality.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens1000
Stars0
Forks1
Last Update2026-01-19

Tags

SearXNGMetasearchPrivacyAgentic AIMCP