Which integrations are available for this server?

Provides access to arXiv search results via a self-hosted SearXNG instance. Provides access to Brave search results via a self-hosted SearXNG instance. Provides access to DuckDuckGo search results via a self-hosted SearXNG instance. Provides access to Google search results via a self-hosted SearXNG instance. Integrates with SearXNG to perform web searches across multiple engines with automatic fallback and rate limit handling. Provides access to Wikipedia search results via a self-hosted SearXNG instance.

How do I use mcp-searxng-local?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-searxng-local search for latest AI news" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-searxng-local

by dduartee

Overview Schema Related Servers Score Discussions

TypeScript

Local

mcp-searxng-local

License: MIT Node tests

MCP server for web search via SearXNG — zero API keys, zero cost, 100% local.

Why not Exa? Costs money. Why not Brave? Requires API key. This: self-hosted, unlimited queries, your data never leaves your machine.

Rate Limit Handling & Fallback

Search engines (Google, DuckDuckGo, Brave) frequently block server IPs with CAPTCHAs or rate limits. mcp-searxng-local handles this automatically:

Local query — queries your self-hosted SearXNG with configured engines
Detection — if all engines return 0 results and are marked unresponsive, triggers fallback
Fallback — automatically retries against public SearXNG instances in order
Transparent — response always includes ## Unresponsive Engines section showing what failed and why

# Configure fallback instances (comma-separated, tried in order)
export SEARXNG_FALLBACK_URLS="https://search.rhscz.eu,https://searx.tiekoetter.com,https://searxng.website"

Pre-configured in opencode.json with 3 public instances. Works out of the box — no setup needed.

Related MCP server: searxng-mcp

Prerequisites

Node.js >= 20
Docker + Docker Compose v2

Quick Start

git clone https://github.com/dduartee/mcp-searxng-local
cd mcp-searxng-local
npm install && npm run build
docker compose up -d

# Verify SearXNG is responding
curl -s "http://localhost:4000/search?q=test&format=json" | python3 -c "import sys,json; print(len(json.load(sys.stdin).get('results',[])), 'results')"

# Verify MCP server works
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js
# Expected: {"jsonrpc":"2.0","id":1,"result":{"tools":[...]}}

Then add to your MCP client config below. Restart your client for the tools to appear.

Path note: replace /home/user/mcp-searxng-local in examples below with your actual clone path.

Why mcp-searxng-local?

	Exa MCP	Brave MCP	mcp-searxng-local
API key	Required	Required	None
Cost	Paid (limited free)	2k/mo free	Unlimited
Privacy	Cloud (USA)	Cloud	100% local
Engines	Proprietary index	Brave only	Google, DDG, Brave, Wikipedia, arXiv
Highlights	AI (paid)	No	Keyword matching (free)
Cache	Server-side	No	LRU local (5min TTL)

Tools

`web_search` / `web_search_advanced`

Parameter	Type	Default	Description
`query`	string	(required)	Search query
`count`	number	`10`	Results (1-50)
`pageno`	number	`1`	Page number
`categories`	enum	—	`general`, `news`, `images`, `files`, `video`, `music`
`time_range`	enum	—	`day`, `month`, `year`
`language`	string	—	`pt-BR`, `en-US`, etc.
`includeDomains`	string[]	—	Only results from these domains
`excludeDomains`	string[]	—	Exclude these domains
`engines`	string	—	`google,duckduckgo,brave,wikipedia,arxiv,bing`
`safesearch`	number	—	`0`=off, `1`=moderate, `2`=strict
`startPublishedDate`	string	—	ISO date: `"2025-01-01"` (client-side filter)
`endPublishedDate`	string	—	ISO date: `"2025-12-31"` (client-side filter)

Response includes: results + direct answers, infoboxes, spelling suggestions, search suggestions, and unresponsive engine diagnostics.

`web_fetch`

Parameter	Type	Default	Description
`url`	string	(required)	Full URL
`maxChars`	number	`5000`	Character limit (100-50000)
`mode`	enum	`text`	`text` (full page) or `highlights` (relevant excerpts)
`query`	string	—	Required for `highlights` mode

Highlights tip: Results are typically ~98% smaller than full page text. Use mode=highlights with the same query that led you to the URL.

Setup

After adding the config, restart your MCP client for the tools to appear.

OpenCode

# CLI (adds to global config)
opencode mcp add mcp-searxng-local -- node /home/user/mcp-searxng-local/dist/index.js

// Project config: ./opencode.json (relative path)
{ "mcp": { "mcp-searxng-local": { "type": "local", "command": ["node", "dist/index.js"] } } }

// Global config: ~/.config/opencode/opencode.json (absolute path)
{ "mcp": { "mcp-searxng-local": { "type": "local", "command": ["node", "/home/user/mcp-searxng-local/dist/index.js"] } } }

Claude Code

{
  "mcpServers": {
    "mcp-searxng-local": {
      "command": "node",
      "args": ["/home/user/mcp-searxng-local/dist/index.js"],
      "env": { "SEARXNG_HOST": "localhost", "SEARXNG_PORT": "4000" }
    }
  }
}

Cursor

// .cursor/mcp.json
{ "mcpServers": { "mcp-searxng-local": { "command": "node", "args": ["/home/user/mcp-searxng-local/dist/index.js"] } } }

VS Code · Windsurf · Zed · Codex · Antigravity

See Install Guide for all client configs.

Configuration

Env var	Default	Description
`SEARXNG_HOST`	`localhost`	SearXNG host
`SEARXNG_PORT`	`4000`	SearXNG port
`SEARXNG_TIMEOUT`	`10000`	HTTP timeout (ms)
`SEARXNG_FALLBACK_URLS`	—	Comma-separated public SearXNG URLs (auto-retry when local engines are rate-limited or blocked)
`DEBUG`	`false`	Enable verbose logging

Also accepts MCP_SEARCH_LOCAL_ prefix: MCP_SEARCH_LOCAL_SEARXNG_HOST, MCP_SEARCH_LOCAL_SEARXNG_PORT, MCP_SEARCH_LOCAL_TIMEOUT, MCP_SEARCH_LOCAL_DEBUG.

Troubleshooting

Symptom	Cause	Fix
Tools don't appear	Path wrong or build missing	Run `npm run build`, verify `dist/index.js` exists
`web_search` connection error	SearXNG not running	`docker compose up -d`
`## Unresponsive Engines` with `brave: too many requests`	Engine blocked/rate-limited	Auto-fallback handles this — no action needed. Add `SEARXNG_FALLBACK_URLS` for more options
All engines return 0 results + all unresponsive	Server IP blocked by search providers	Set `SEARXNG_FALLBACK_URLS` to public instances. Fallback retries automatically
Fallback returns 0 results too	Public instances also blocked or down	Try different instances in `SEARXNG_FALLBACK_URLS`, or wait and retry later
Highlights returns full page	Page has no paragraph breaks or all text matches query	Use `mode=text` with smaller `maxChars`
`web_fetch` timeout (15s)	Page is slow or .js-heavy SPA	Reduce `maxChars`, try a different URL

Testing

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"web_search","arguments":{"query":"test"}}}' | node dist/index.js

npm test             # 28 unit tests
npm run inspector    # MCP Inspector UI

Architecture

MCP Client (OpenCode, Claude Code, Cursor...)
  │ stdio or Streamable HTTP
  ▼
mcp-searxng-local (Node.js + TypeScript)
  │ HTTP + LRU cache + exponential backoff retry
  ▼
SearXNG (Docker) ← Google, DuckDuckGo, Brave, Wikipedia, arXiv
  │ if all engines unresponsive → auto-fallback
  ▼
Public SearXNG instances (search.rhscz.eu, searx.tiekoetter.com, ...)

Documentation

Doc	Description
Install Guide	Project, global, and plugin-based setup
Examples	Real agent workflows and CLI usage
Architecture	Internal design, data flow, decisions
Search Insights	What AI agents actually need from search
Comparison	vs Exa, Brave, SearXNG raw, Chrome DevTools

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/dduartee/mcp-searxng-local'

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

mcp-searxng-local

Rate Limit Handling & Fallback

Prerequisites

Quick Start

Why mcp-searxng-local?

Tools

web_search / web_search_advanced

web_fetch

Setup

OpenCode

Claude Code

Cursor

VS Code · Windsurf · Zed · Codex · Antigravity

Configuration

Troubleshooting

Testing

Architecture

Documentation

License

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API

`web_search` / `web_search_advanced`

`web_fetch`