🔍 SearXNG MCP Server
Private web search for AI assistants — connect any SearXNG instance to Claude, Cursor, and more.
An MCP server that integrates the SearXNG API, giving AI assistants web search capabilities.
✨ Featured in the GitHub MCP Registry.
Quick Start
Add to your MCP client configuration (e.g. claude_desktop_config.json):
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}Replace YOUR_SEARXNG_INSTANCE_URL with the URL of your SearXNG instance (e.g. https://searxng.example.com). You can also provide interchangeable replicas as a semicolon-separated list, e.g. https://one.example.com;https://two.example.com.
Features
- Web Search: General queries, news, articles, with pagination.
- Instance Failover: Configure multiple interchangeable SearXNG replicas in
SEARXNG_URL; searches fail over by default and can optionally fan out in parallel. - Structured Search Output: Choose formatted text or raw SearXNG-shaped JSON with
response_format. - Direct Answers & Metadata: Text results surface SearXNG answers, corrections, suggestions, and infoboxes before result lists.
- Search Suggestions: Query autocomplete via SearXNG's
/autocompleterendpoint. - Instance Capability Discovery: Inspect configured categories, engines, defaults, locales, and plugins from
/config. - URL Content Reading: Advanced content extraction with pagination, section filtering, and heading extraction.
- Intelligent Caching: URL content is cached with TTL (Time-To-Live) to improve performance and reduce redundant requests.
- Pagination: Control which page of results to retrieve.
- Time Filtering: Filter results by time range (day, week, month, year).
- Language Selection: Filter results by preferred language.
- Safe Search: Control content filtering level for search results.
- Relevance Filtering: Filter out low-scoring search results with
min_score.
