A
securityA
licenseA
qualityAn MCP server for connecting agentic systems to search systems via searXNG.
Last updated -
1
104
MIT License
This SearXNG server provides web search and content retrieval capabilities with multiple customization options:
Web Search: Perform general queries, news, and article searches
Content Retrieval: Read and convert URL content into markdown
Filtering Options:
Pagination control to manage result sets
Time filtering (day, month, year)
Language filtering
Safe search content filtering
Integrates the SearXNG API to provide web search capabilities with pagination support, allowing for general queries, news, and article searches.
SearXNG MCP Server
An MCP server implementation that integrates the SearXNG API, providing web search capabilities.
Features
Web Search: General queries, news, articles, with pagination.
Pagination: Control which page of results to retrieve.
Time Filtering: Filter results by time range (day, month, year).
Language Selection: Filter results by preferred language.
Safe Search: Control content filtering level for search results.
Tools
searxng_web_search
Execute web searches with pagination
Inputs:
query(string): The search query. This string is passed to external search services.pageno(number, optional): Search page number, starts at 1 (default 1)time_range(string, optional): Filter results by time range - one of: "day", "month", "year" (default: none)language(string, optional): Language code for results (e.g., "en", "fr", "de") or "all" (default: "all")safesearch(number, optional): Safe search filter level (0: None, 1: Moderate, 2: Strict) (default: instance setting)
web_url_read
Read and convert the content from a URL to markdown
Inputs:
url(string): The URL to fetch and process
Configuration
Setting the SEARXNG_URL
Choose a SearxNG instance from the list of public instances or use your local environment.
Set the
SEARXNG_URLenvironment variable to the instance URL.The default
SEARXNG_URLvalue ishttp://localhost:8080.
Usage with Claude Desktop
Installing via Smithery
To install SearxNG Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude
NPX
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
NPM
npm install -g mcp-searxng
And then in your MCP config file:
{
"mcpServers": {
"searxng": {
"command": "mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
Docker
Using Pre-built Image from Docker Hub
docker pull isokoliuk/mcp-searxng:latest
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"isokoliuk/mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
Build Locally
docker build -t mcp-searxng:latest -f Dockerfile .
Use
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
An MCP server implementation that integrates the SearXNG API, providing web search capabilities.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.Last updated -15
- -securityAlicense-qualityAn MCP server that enables web searches using a SearxNG instance, allowing MCP-compatible applications like Goose to perform internet searches.Last updated -1GPL 3.0
- AsecurityAlicenseAqualityAn MCP server that allows searching through public SearXNG instances by parsing HTML content into JSON results, enabling metasearch capabilities without requiring JSON API access.Last updated -18819MIT License