A
licenseA
qualityA
maintenanceAn MCP server implementation that integrates the SearxNG API, providing web search capabilities.
Last updated
51
2
27,926
1,092
MIT
mcp-searxng-local
by dduartee
This server provides local, zero-cost, and private web search and content extraction capabilities via a locally hosted SearXNG instance — no API keys required.
web_search / web_search_advanced — Search the web aggregating multiple engines (Google, DuckDuckGo, Brave, Wikipedia, arXiv), returning titles, URLs, snippets, direct answers, and infoboxes. web_search_advanced is semantically hinted for the LLM to apply filters more carefully (e.g., "articles from the last month only from arxiv.org").
Filter by category:
general,news,images,files,video,musicFilter by time range:
day,month, oryearInclude or exclude specific domains (e.g., only
github.com, excludepinterest.com)Filter by publication date range (ISO date, client-side)
Select specific search engines, set language (e.g.,
en-US), and control safe search levelPaginate results (up to 50 per page)
web_fetch — Extract clean text content from any webpage.
textmode: returns full page contenthighlightsmode: returns only the most relevant excerpts for a given query (~10x fewer tokens, ~98% smaller)Configurable character limit (100–50,000 characters)
Optimized handling for GitHub URLs
Ideal for reading articles, documentation, and blogs
The server runs locally, is configurable via environment variables, and supports fallback to public SearXNG instances.
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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-searxng-localsearch 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
MCP server for web search via SearXNG — zero API keys, zero cost, 100% local.
Prerequisites
Related MCP server: searxng-mcp
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
curl -s "http://localhost:4000/search?q=test&format=json" | python3 -c "import sys,json; print(len(json.load(sys.stdin).get('results',[])), 'results')"For Termux (no Docker), see the Termux Install Guide.
Tools
Tool | Description |
| Search via Google, DuckDuckGo, Brave, Wikipedia, arXiv. Supports domain/date filters, engine selection. |
| Same as |
| Extract page content. |
web_search / web_search_advanced parameters
Parameter | Type | Default | Description |
| string | (required) | Search query |
| number |
| Results (1-50) |
| number |
| Page number |
| enum | — |
|
| enum | — |
|
| string | — |
|
| string[] | — | Only results from these domains |
| string[] | — | Exclude these domains |
| string | — |
|
| number | — |
|
| string | — | ISO date (client-side filter) |
| string | — | ISO date (client-side filter) |
web_fetch parameters
Parameter | Type | Default | Description |
| string | (required) | Full URL |
| number |
| Character limit (100-50000) |
| enum |
|
|
| string | — | Required for |
Setup
After adding the config, restart your MCP client for the tools to appear.
Replace /home/user/mcp-searxng-local with your actual clone path.
OpenCode
opencode mcp add mcp-searxng-local -- node /home/user/mcp-searxng-local/dist/index.js// ./opencode.json (project) or ~/.config/opencode/opencode.json (global)
{ "mcp": { "mcp-searxng-local": { "type": "local", "command": ["node", "/home/user/mcp-searxng-local/dist/index.js"] } } }Claude Code / Cursor / VS Code / Windsurf
{
"mcpServers": {
"mcp-searxng-local": {
"command": "node",
"args": ["/home/user/mcp-searxng-local/dist/index.js"]
}
}
}For VS Code use "servers" instead of "mcpServers". For Windsurf, config goes in ~/.windsurf/mcp.json. See the Install Guide for all client configs.
Configuration
All env vars are optional — defaults work for local SearXNG on port 4000.
Env var | Default | Description |
|
| SearXNG host |
|
| SearXNG port |
|
| HTTP timeout (ms) |
| — | Comma-separated public SearXNG URLs (auto-retry when local engines are blocked) |
| — | GitHub PAT — raises API rate limit from 60 to 5000 req/h |
|
| Enable verbose logging |
Also accepts MCP_SEARCH_LOCAL_ prefix (e.g. MCP_SEARCH_LOCAL_SEARXNG_HOST).
The server loads .env files automatically via dotenv.
Troubleshooting
Symptom | Fix |
Tools don't appear | Run |
| SearXNG not running: |
| Auto-fallback handles this. Add |
Highlights returns full page | Use |
See Install Guide for full troubleshooting.
Documentation
Doc | Description |
Local, clone, global+plugin, and all MCP client configs | |
SearXNG native install on Android — no Docker | |
Request flow, design decisions, directory structure | |
JSON-RPC payloads, agent workflows, CLI testing | |
vs Exa, Brave, SearXNG raw, Chrome DevTools | |
Optimized GitHub URL handling in | |
What AI agents actually need from search |
License
MIT
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server that wraps a local SearXNG instance to provide private, customizable web search capabilities. It enables AI assistants to perform queries with support for specific parameters like results limits, language, and time ranges.Last updated248MIT
- Alicense-qualityCmaintenanceA privacy-friendly web search MCP server using SearXNG, enabling searches across multiple engines and categories.Last updated1MIT
- Alicense-qualityDmaintenanceAn MCP server that integrates the SearXNG API to provide web search with pagination, filtering, and URL content extraction.Last updated35MIT
Related MCP Connectors
Serper MCP — wraps the Serper Google Search API (serper.dev)
MCP server for Google search results via SERP API
An MCP server that gives your AI access to the source code and docs of all public github repos
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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