SearXNG Server

Integrations

  • Integrates the SearXNG API to provide web search capabilities with pagination support, allowing for general queries, news, and article searches.

SearXNG MCP Server

An MCP server implementation that integrates the SearXNG API, providing web search capabilities.

Features

  • Web Search: General queries, news, articles, with pagination.
  • Pagination: Control which page of results to retrieve.
  • Time Filtering: Filter results by time range (day, month, year).
  • Language Selection: Filter results by preferred language.
  • Safe Search: Control content filtering level for search results.

Tools

  • searxng_web_search
    • Execute web searches with pagination
    • Inputs:
      • query (string): The search query. This string is passed to external search services.
      • pageno (number, optional): Search page number, starts at 1 (default 1)
      • time_range (string, optional): Filter results by time range - one of: "day", "month", "year" (default: none)
      • language (string, optional): Language code for results (e.g., "en", "fr", "de") or "all" (default: "all")
      • safesearch (number, optional): Safe search filter level (0: None, 1: Moderate, 2: Strict) (default: instance setting)
  • web_url_read
    • Read and convert the content from a URL to markdown
    • Inputs:
      • url (string): The URL to fetch and process

Configuration

Setting the SEARXNG_URL

  1. Choose a SearxNG instance from the list of public instances or use your local environment.
  2. Set the SEARXNG_URL environment variable to the instance URL.
  3. The default SEARXNG_URL value is http://localhost:8080.

Usage with Claude Desktop

Installing via Smithery

To install SearxNG Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude

NPX

{ "mcpServers": { "searxng": { "command": "npx", "args": [ "-y", "mcp-searxng" ], "env": { "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL" } } } }

NPM

npm install -g mcp-searxng

And then in your MCP config file:

{ "mcpServers": { "searxng": { "command": "mcp-searxng", "env": { "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL" } } } }

Docker

Using Pre-built Image from Docker Hub
docker pull isokoliuk/mcp-searxng:latest

Add this to your claude_desktop_config.json:

{ "mcpServers": { "searxng": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SEARXNG_URL", "isokoliuk/mcp-searxng:latest" ], "env": { "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL" } } } }
Build Locally
docker build -t mcp-searxng:latest -f Dockerfile .
Use

Add this to your claude_desktop_config.json:

{ "mcpServers": { "searxng": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SEARXNG_URL", "mcp-searxng:latest" ], "env": { "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL" } } } }

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

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

An MCP server implementation that integrates the SearXNG API, providing web search capabilities.

  1. Features
    1. Tools
      1. Configuration
        1. Setting the SEARXNG_URL
        2. Usage with Claude Desktop
        3. Installing via Smithery
        4. NPX
        5. NPM
        6. Docker
      2. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
          Last updated -
          2
          20,301
          44,650
          JavaScript
          MIT License
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          An MCP server for connecting agentic systems to search systems via searXNG.
          Last updated -
          1
          43
          Python
          MIT License
        • -
          security
          A
          license
          -
          quality
          A server based on the MCP protocol that uses the Brave API for web search functionality.
          Last updated -
          6
          Python
          MIT License
          • Apple
          • Linux
        • -
          security
          A
          license
          -
          quality
          MCP server for using various search tools like Tavily API. Planning to support various search tools (i.e. wiki search, searxng, etc)
          Last updated -
          1
          Python
          MIT License
          • Apple
          • Linux

        View all related MCP servers

        ID: 0j7jjyt7m9