mcpField
M
mcp-searxng-public

mcp-searxng-public

Local
github.com/pwilkinSearch57Updated 23w ago
Repository

About mcp-searxng-public

mcp-searxng-public is an MCP server that queries public SearXNG instances and parses their HTML results into JSON. It targets setups where public instances do not expose the JSON output format, and it can fall back across up to three instances.

Key features

  1. 01Queries public SearXNG instances
  2. 02Parses HTML results into JSON
  3. 03Up to three instances with fallback
  4. 04Optional time range and language parameters
  5. 05Detailed mode merges and deduplicates pages

Use cases

  1. 01Giving an AI assistant web search through an MCP client
  2. 02Searching on public instances without a JSON API

MCP support

This project is an MCP server that exposes a search tool, which takes arguments such as query and returns an array of objects with url and summary fields.

#mcp-searxng#mcp-server#search-engine

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "searxng-public": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng-public"
      ],
      "env": {
        "SEARXNG_BASE_URL": "<SEARXNG_BASE_URL>",
        "DEFAULT_LANGUAGE": "<DEFAULT_LANGUAGE>"
      }
    }
  }
}
Run commandnpx -y mcp-searxng-public
Environment variables to set
SEARXNG_BASE_URL
DEFAULT_LANGUAGE

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-searxng-public

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringYesThe search query.
time_rangestringNoThe optional time range for the search, from: [day, week, month, year].
languagestringNoThe optional language code for the search (e.g., en, es, fr).
detailedstringNoOptionally, if true, will perform a more thorough search - will ask for more pages of results and will merge results from multiple servers. Warning: this might overload the servers and cause errors. Do not set to true by default unless explicitly asked to perform a detailed or comprehensive query.

Details

From the project README

mcp-searxng-public

An MCP server that queries public SearXNG instances, parsing HTML contents into a JSON result

SearXNG Server MCP server

Rationale

All the MCP servers for SearXNG that I've seen use "json" as the output format. While that is certainly a faster way to code a SearXNG MCP server, it will make it fail on virtually all public servers since they don't expose the JSON format.

This server will read from up to three public SearXNG servers (using one as main and the others as fallback) and will parse the results into JSON.

Installation

Install via npm install mcp-searxng-public.

If the server is installed, the run configuration is (for Cursor or Cursor-compatible clients) as follows:

{
  "SearXNGScraper": {
    "command": "npx",
    "args": ["mcp-searxng-public"],
    "capabilities": {
      "tool-calls": true
    },
    "env": {
      "SEARXNG_BASE_URL": "https://metacat.online;https://nyc1.sx.ggtyler.dev;https://ooglester.com;https://search.080609.xyz;https://search.canine.tools;https://search.catboy.house;https://search.citw.lgbt;https://search.einfachzocken.eu;https://search.federicociro.com;https://search.hbubli.cc;https://search.im-in.space;https://search.indst.eu",
      "DEFAULT_LANGUAGE": "en"
    }
  }
}

Note: You may need to adjust the env variables, particularly SEARXNG_BASE_URL, to point to your preferred SearXNG instances. The DEFAULT_LANGUAGE can also be set as needed. You can run the report task to get a report on good (accessible) SearXNG instances which you can put in the URLs line.

Add MCP Server sear-xng-scraper to LM Studio

Usage

The server exposes one endpoint: search. The endpoint takes four arguments:

  • query - the search query
  • time_range (optional) - which takes a time range parameter according to the https://docs.searxng.org/dev/search_api.html spec (day, month or year).
  • language (optional) - the language code for the search (e.g., en, es, fr). If not provided, it defaults to the value of the DEFAULT_LANGUAGE environment variable. If neither is set, no language parameter is sent to SearXNG.
  • detailed (optional) - if set to "true", performs a more thorough search by querying up to 3 servers and fetching multiple pages of results (pages 1, 2, and 3) from each server, then merging and deduplicating the results.

Returned is an array of objects:

[
      {
        "url": "https://github.com/searxng/searxng",
        "summary": "You can start SearXNG using make run in the terminal or by pressing Ctrl+Shift+B"
      },
      {
        "url": "https://searx.bndkt.io/",
        "summary": "Powered by searxng - 2025.3.22+5986629c6 — a privacy-respecting, open metasearch engine Source code | Issue tracker | Engine stats | Public instances | Contact instance maintainer"
      },
      {
        "url": "https://docs.searxng.org/"
        "summary": "SearXNG is a free internet metasearch engine which aggregates results from up to 243 search services. Users are neither tracked nor profiled. Additionally, SearXNG can be used over Tor …"
      }
      {
        "url": "https://en.wikipedia.org/wiki/SearXNG",
        "summary": "SearXNG is federated, and as such is hosted by several instances, public and private. Private instances are hosted on a local network, or run on the user&#x27;s desktop computer itself, and are …"
      }
]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.