SearXNG MCP Server
@ihor-sokoliuk
About SearXNG MCP Server
Private web search for AI assistants via SearXNG — supports Claude, Cursor, and any MCP client
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"isokoliuk/mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "<YOUR_SEARXNG_INSTANCE_URL>"
}
}
}
}Tools
4Execute web searches with pagination
Get autocomplete suggestions for refining search queries
Discover categories, engines, defaults, locales, and plugins exposed by all reachable configured SearXNG instances. The response reports `common` values present on every reachable instance and `available` values present on at least one reachable instance.
Read URL content as markdown with content-type-aware handling and advanced extraction options
Overview
What is SearXNG MCP Server?
SearXNG MCP Server is an MCP server that integrates the SearXNG API, enabling AI assistants to perform private, self-hosted web searches through any SearXNG instance. It connects assistants like Claude and Cursor to web search, URL content reading, and instance capability discovery without requiring external API keys.
How to use SearXNG MCP Server?
Configure your MCP client (e.g., Claude Desktop) with the server command (npx -y mcp-searxng or Docker) and set the SEARXNG_URL environment variable to your SearXNG instance URL. Once connected, your assistant can invoke tools like searxng_web_search, searxng_search_suggestions, searxng_instance_info, and web_url_read.
Key features of SearXNG MCP Server
- Web search with pagination, time, language, safe search, and relevance filters
- Instance failover and optional parallel fan-out across multiple replicas
- Structured search output (formatted text or raw JSON)
- URL content reading with markdown conversion and advanced extraction
- Search suggestions and instance capability discovery
- Intelligent caching with configurable TTL for URL content
Use cases of SearXNG MCP Server
- Provide private, self-hosted web search to AI assistants like Claude and Cursor
- Retrieve and read web page content without exposing data to third-party services
- Search news, articles, or technical documentation with relevant filters
- Discover a SearXNG instance’s categories, engines, defaults, and plugins programmatically
- Get search suggestions to refine queries interactively
FAQ from SearXNG MCP Server
What does SearXNG MCP Server do compared to other search MCP servers?
It is free, privacy-preserving, fully self-hosted, and supports web search, URL reading, pagination, failover, and more without requiring an API key.
Do I need a SearXNG instance to use it?
Yes, you must point the server at an existing SearXNG instance via the SEARXNG_URL environment variable. This server is not a native SearXNG plugin.
Can I
Frequently asked questions
What does SearXNG MCP Server do compared to other search MCP servers?
It is free, privacy-preserving, fully self-hosted, and supports web search, URL reading, pagination, failover, and more without requiring an API key.
Do I need a SearXNG instance to use it?
Yes, you must point the server at an existing SearXNG instance via the `SEARXNG_URL` environment variable. This server is not a native SearXNG plugin.
Basic information
More Search MCP servers
Everything Search MCP Server
mamertofabian
🚀 OneSearch MCP Server: Web Search & Crawl & Scraper & Extract
yokingma🚀 OneSearch MCP Server: Web Search & Scraper & Extract, Support agent-browser, SearXNG, Tavily, DuckDuckGo, Bing, etc.
Brave Search
modelcontextprotocolModel Context Protocol Servers
DuckDuckGo Search MCP Server
nickclydeA Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
Baidu AI Search
baidubceappbuilder-sdk, 千帆AppBuilder-SDK帮助开发者灵活、快速的搭建AI原生应用
Comments