Skip to main content
Glama

SearXNG Model Context Protocol Server

by aeon-seraph

SearXNG Model Context Protocol Server

A Model Context Protocol (MCP) server for interfacing language models with SearXNG search engine.

Description

This server enables language models to perform web searches through SearXNG using the Model Context Protocol standard. It provides a clean interface for language models to send search queries to SearXNG and receive formatted results.

Installation

# Clone the repository git clone https://github.com/aeon-seraph/searxng-mcp.git cd searxng-mcp # Install dependencies npm install # Build the project npm run build

Requirements

  • Node.js 16+
  • A running SearXNG instance (by default at http://localhost:8888)

Usage

# Run the server node build/index.js

The server will run on stdio, making it suitable for integration with MCP-compatible language models.

Configuration

The server can be configured using environment variables:

VariableDescriptionDefault
SEARXNG_PROTOCOLProtocol to use (http/https)http
SEARXNG_HOSTSearXNG hostlocalhost
SEARXNG_PORTSearXNG port8888
CACHE_TTLCache time-to-live in milliseconds600000 (10 minutes)
MAX_CACHE_SIZEMaximum number of cached queries100

Example:

SEARXNG_HOST=mysearx.example.com SEARXNG_PORT=443 SEARXNG_PROTOCOL=https node build/index.js

Docker

The project includes a Dockerfile for easy deployment:

# Build the Docker image docker build -t searxng-mcp . # Run the container docker run -e SEARXNG_HOST=mysearx.example.com -e SEARXNG_PROTOCOL=https searxng-mcp

Search Parameters

The search function supports the following parameters:

  • query (required): The search query string
  • categories: Comma-separated list of search categories
  • pageno: Search page number (default: 1)
  • time_range: Time range for results ("day", "week", "month", "year")
  • raw_json: Return raw JSON response instead of formatted text (default: false)

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A server that enables language models to perform web searches through SearXNG using the Model Context Protocol standard.

  1. Description
    1. Installation
      1. Requirements
        1. Usage
          1. Configuration
            1. Docker
              1. Search Parameters
                1. License

                  Related MCP Servers

                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.
                    Last updated -
                    1,093
                    44
                    TypeScript
                    MIT License
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables semantic search capabilities by providing tools to manage Qdrant vector database collections, process and embed documents using various embedding services, and perform semantic searches across vector embeddings.
                    Last updated -
                    4
                    51
                    TypeScript
                    MIT License
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to perform web searches using SearXNG, a privacy-respecting metasearch engine.
                    Last updated -
                    1
                    14
                    JavaScript
                    MIT License
                    • Linux
                    • Apple
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.
                    Last updated -
                    13
                    8
                    Python
                    • Linux
                    • Apple

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/aeon-seraph/searxng-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server