Provides web search capabilities through a SearXNG instance, allowing for queries across various categories such as news, images, videos, and science with support for language, time range, and safe search filtering.
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., "@SearXNG MCP Serversearch for the latest AI news from the past week"
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.
SearXNG MCP Server
A Model Context Protocol (MCP) server that provides web search capabilities using SearXNG.
Features
š Web search using your SearXNG instance
šÆ Category filtering (general, news, images, videos, science, etc.)
š Multi-language support
ā° Time range filtering
š”ļø Safe search options
š Formatted results with titles, URLs, snippets, and metadata
Quick Start
Prerequisites
Node.js 18 or higher
A running SearXNG instance
ngrok (for public sharing)
Installation
Configuration
The server uses the SearXNG instance at http://192.168.1.44:55001 by default. You can override this with the SEARXNG_URL environment variable:
Running Locally
Sharing Publicly with ngrok
Install ngrok if you haven't already:
npm install -g ngrokStart the MCP server:
npm startIn another terminal, expose it via ngrok:
ngrok http 3000Use the ngrok URL in your MCP client configuration
Usage in LM Studio
For Local Use
Add this to your LM Studio MCP settings:
For Public/Shared Use (via ngrok)
When sharing with others, they can use this configuration:
Note: For the npx version to work, you'll need to publish this to npm first.
Available Tools
web_search
Search the web using SearXNG.
Parameters:
query(required): The search querycategories(optional): Search categories - "general", "news", "images", "videos", "science", etc. Default: "general"language(optional): Language code like "en", "es", "fr". Default: "en"time_range(optional): Filter by time - "day", "week", "month", "year". Default: all timesafesearch(optional): Safe search level - 0 (off), 1 (moderate), 2 (strict). Default: 0
Example:
Development
Project Structure
Testing
You can test the server using any MCP-compatible client like:
LM Studio
Claude Desktop
Other MCP clients
Troubleshooting
Connection Issues
If you can't connect to SearXNG:
Verify your SearXNG instance is running:
curl http://192.168.1.44:55001Check firewall settings
Ensure the URL is correct in the configuration
No Results
If searches return no results:
Test the same query directly in SearXNG web interface
Try different categories or remove filters
Check SearXNG logs for errors
License
MIT