Searxng Mul Mcp

What is Searxng Mul Mcp?

Searxng Mul Mcp is a Model Context Protocol (MCP) server for integrating SearXNG, a metasearch engine, into MCP-compatible clients. It enables multi-query parallel search and supports both stdio and HTTP transport protocols. Designed for developers and AI assistants, it provides a single search tool to query SearXNG via its REST API without browser automation.

How to use Searxng Mul Mcp?

You can run it directly via npx (e.g., SEARXNG_URL=https://your.searxng.com npx -y searxng-mul-mcp) or deploy with Docker. Configure via environment variables: SEARXNG_URL (required), optional USERNAME/PASSWORD for Basic Auth, TRANSPORT, HOST, PORT. For HTTP mode, add --transport=http --host=0.0.0.0 --port=3000. Integrate with Claude Desktop by adding a mcpServers entry in claude_desktop_config.json. Install from source with npm install && npm run build && npm start.

Key features of Searxng Mul Mcp

• Multi-query parallel search for improved efficiency
• Dual transport support (stdio and HTTP)
• Direct SearXNG REST API integration without browser automation
• Basic Authentication support for secured SearXNG instances
• Docker deployment with Docker and Docker Compose
• Environment-based configuration and structured logging

Use cases of Searxng Mul Mcp

• Run concurrent SearXNG searches from an AI assistant like Claude
• Integrate private or public SearXNG instances into MCP-based workflows
• Deploy a search proxy with health checks and session management
• Customize search parameters (engines, categories, safesearch, language)

FAQ from Searxng Mul Mcp

What do I need to run Searxng Mul Mcp?

A SearXNG instance URL is required. Node.js 18+ for source/npx usage, or Docker for containerized deployment. Optionally, Basic Auth credentials if your SearXNG server is protected.

How do I switch between stdio and HTTP transports?

Set TRANSPORT=stdio or TRANSPORT=http in environment variables, or use the --transport CLI flag. HTTP mode requires HOST and PORT (default 0.0.0.0:3000) and provides a /health endpoint and /mcp endpoint for clients.

How does authentication work?

If your SearXNG server uses Basic Auth, provide USERNAME and PASSWORD as environment variables. The server passes these credentials along with API requests.

What search parameters can I use?

The single search tool accepts required queries (array of strings), and optional engines, categories, safesearch (0–2), and language (e.g., "en", "zh").

How are errors handled?

Network errors retry up to 3 times. Authentication failures, API rate limits, and timeouts (default 30 seconds) produce clear error messages. Enable DEBUG=true for detailed logging.