SearXNG MCP Server
About
A Model Context Protocol (MCP) server that enables AI assistants to perform web searches using SearXNG, a privacy-respecting metasearch engine.
Explore
- Zero-configuration setup: Works immediately by using a random public instance from SearX.space
- Private instance support: Connect to your own SearXNG instance with optional basic authentication
- Perform web searches with customizable parameters
- Support for multiple search engines
- Privacy-focused search results
- Markdown-formatted search results
- Sensible default values for all parameters
CAVEAT - Public Instances might be unavailabe for this purpose and return "Request failed with status code 429"
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SearXNG MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js (v16 or higher)
- npm (v7 or higher)
- Access to a SearXNG instance (self-hosted or public)
npm install
searxngmcp
node build/index.js
SearXNG MCP can be easily integrated with Smolagents, a lightweight framework for building AI agents. This allows you to create powerful research agents that can search the web and process the results:
from smolagents import CodeAgent, LiteLLMModel, ToolCollection
from mcp import StdioServerParameters
server_parameters = StdioServerParameters(
command="node",
args=["path/to/searxng-mcp/build/index.js"],
env={
"SEARXNG_URL": "https://your-searxng-instance.com",
"SEARXNG_USERNAME": "your_username", # Optional
"SEARXNG_PASSWORD": "your_password" # Optional
}
)
with ToolCollection.from_mcp(server_parameters) as tool_collection:
search_agent = CodeAgent(
name="search_agent",
tools=tool_collection.tools,
model=model
)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"searxng mcp server": {
"searxngmcp": {
"command": "searxngmcp",
"disabled": false,
"autoApprove": []
}
}
}
}McpServers
{
"searxngmcp": {
"command": "searxngmcp",
"disabled": false,
"autoApprove": []
}
}<p align="center">
</p>
A Model Context Protocol (MCP) server that enables AI assistants to perform web searches using SearXNG, a privacy-respecting metasearch engine. Works out-of-the-box with zero additional deployment by automatically selecting a random instance from SearX.space, while also supporting private instances with basic authentication.
This project is deprecated. Its successor is searxNcrawl at https://github.com/DasDigitaleMomentum/searxNcrawl
Deprecated
This repository is deprecated in favor of searxNcrawl. The successor currently does not include round-robin instance selection (it is usually unreliable). If you file a suitable defect report, it can be added.
Features
- Zero-configuration setup: Works immediately by using a random public instance from SearX.space
- Private instance support: Connect to your own SearXNG instance with optional basic authentication
- Perform web searches with customizable parameters
- Support for multiple search engines
- Privacy-focused search results
- Markdown-formatted search results
- Sensible default values for all parameters
CAVEAT - Public Instances might be unavailabe for this purpose and return "Request failed with status code 429"
Installation
Prerequisites
- Node.js (v16 or higher)
- npm (v7 or higher)
- Access to a SearXNG instance (self-hosted or public)
Install from source
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
