# SearXNG MCP Server
**Category:** ๐ป Developer Tools
**Repository:** https://github.com/bumbaRasch/searxng-mcp-server
**Views:** 0
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/searxng-mcp-server
## Description
Self-hosted SearXNG metasearch for MCP clients: web, image, news, video, music and page fetch.
## Claude Desktop Quick Installation
Heuristic fallback โ verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):
```json
"mcpServers": {
"searxng-mcp-server": {
"command": "npx",
"args": ["-y","searxng-mcp-server"]
}
}
```
## Documentation & README
# searxng-mcp-server
Self-hosted [SearXNG](https://github.com/searxng/searxng) metasearch for MCP clients โ nine tools (web, image, news, video, music and paper search, query suggestions, page fetch, instance info) with no API keys and no tracking.
[](https://insiders.vscode.dev/redirect/mcp/install?name=searxng&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22searxng-mcp-server%22%5D%7D)
[](https://cursor.com/en/install-mcp?name=searxng&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22searxng-mcp-server%22%5D%7D)
[](https://www.npmjs.com/package/searxng-mcp-server)
[](./LICENSE)
[](https://github.com/bumbaRasch/searxng-mcp-server/actions/workflows/ci.yml)
[Documentation](https://github.com/bumbaRasch/searxng-mcp-server/blob/HEAD/docs/design.md) ยท [Changelog](https://github.com/bumbaRasch/searxng-mcp-server/blob/HEAD/CHANGELOG.md) ยท [npm](https://www.npmjs.com/package/searxng-mcp-server) ยท [SearXNG](https://github.com/searxng/searxng) ยท [Report an issue](https://github.com/bumbaRasch/searxng-mcp-server/issues)
## Why
Search-API servers mean signups, API keys, rate limits, and provider-side tracking of every query. This server talks to **your own** SearXNG โ a privacy-respecting metasearch engine you self-host โ so it needs no API keys, sends nothing to a third party, and costs nothing to run. `fetch_content` is hardened for exactly this job: SSRF and DNS-rebind guarding on every redirect hop, and prompt-injection wrapping on all web output. MCP `icons` metadata ships on the server and every tool โ self-contained data URIs, rendered by icon-aware clients.
## A typical session
```text
# Arguments are JSON in real MCP calls; this shows the flow:
autocomplete "rust asy" โ suggestions to refine the query
search "rust async" (min_score: 1) โ ranked results + answers + infoboxes
paper_search "attention" (time_range: "year") โ papers with abstracts and PDF links
fetch_content https://result-url.example โ the page as clean Markdown (PDFs too)
```
## Architecture
MCP client โ stdio (default) or Streamable HTTP (opt-in) โ this server โ your SearXNG (Docker) โ upstream engines. Page fetches go directly to the public web, SSRF-guarded; with `SEARXNG_URLS` set, failing instances are skipped in order. Diagram and module map: [docs/design.md](https://github.com/bumbaRasch/searxng-mcp-server/blob/HEAD/docs/design.md).
## Quick start
Requires Node >= 22.19 (the `npx` runtime) and Docker for the SearXNG stack.
### 1. Run SearXNG
```bash
printf 'SEARXNG_SECRET=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
curl -fsS 'http://localhost:8888/search?q=test&format=json' | head -c 80
```
The bundled `docker-compose.yml` enables the JSON API and binds `127.0.0.1` only โ the API is unauthenticated, so never expose the port publicly. Engine credentials (e.g. an OpenAlex `api_key`) belong in `searxng/settings.yml`.
### 2. Add to any MCP client
Works in Claude Desktop, Cursor and most `mcpServers`-style clients:
```json
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "searxng-mcp-server"]
}
}
}
```
`SEARXNG_URL` already defaults to `http://localhost:8888`; add an `env` block only to override. Cursor reads the same shape from `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project).
OpenCode
Global config `~/.config/opencode/opencode.json`:
```json
{
"mcp": {
"searxng": {
"type": "local",
"command": ["npx", "-y", "searxng-mcp-server"],
"enabled": true
}
}
}
```
Claude Code
One command, available in all projects:
```bash
claude mcp add --scope user searxng -- npx -y searxng-mcp-server
```
ZCode
User scope in `~/.zcode/cli/config.json` (`command` is a string, key is `mcp.servers`):
```json
{
"mcp": {
"servers": {
"searxng": {
"type": "stdio",
"command": "npx",
"args": ["-y", "searxng-mcp-server"]
}
}
}
}
```
From source
```bash
git clone https://github.com/bumbaRasch/searxng-mcp-server && cd searxng-mcp-server
pnpm install && pnpm build
```
Then use `node /absolute/path/to/searxng-mcp-server/dist/index.js` as the command in any config above.
Parameters
- **search** โ `query` (string, required unless `queries` is given): max 500 chars. `queries` (string[2โ5]): batch mode, one result set per query in input order. Optional: `categories` (string[]), `engines` (string[]), `language`, `time_range` (`day` | `week` | `month` | `year`), `pageno`, `safesearch` (0/1/2), `max_results` (1โ50, default 10; per query in batch mode), `min_score` (number โฅ 0, drops scored results below it), `detail` (`full` default | `compact` markdown rendering).
- **image_search** / **news_search** / **video_search** / **music_search** / **paper_search** โ `query` (required) plus the shared optional args: `engines`, `language`, `pageno`, `safesearch`, `max_results`, `detail`, and `time_range` (all five support the freshness filter).
- **fetch_content** โ `url` (string, required): absolute http/https, max 2048 chars. `max_chars` (1000โ200000, default `MAX_CHARS` 25000). `offset` (int โฅ 0): window start into the extracted content โ continue from the returned `nextOffset`. `outline: true` adds `headings` (`{text, offset, level}`: markdown `#`-lines, `[Page N]` markers for PDFs) with offsets into the scanned content. `section` returns one heading region only โ case-insensitive exact heading match, through the next same-or-higher-level heading โ with `offset`/`max_chars` applying inside it. `timeout_ms` (max 120000). Text PDFs are extracted per page (`[Page N]` sections, `pages` count in the output).
- **autocomplete** โ `query` (string, required): the prefix to complete, max 200 chars. Suggestions follow the instance's configured language.