Searxng MCP

SearXNG MCP is a model context protocol server based on the SearXNG privacy-protecting metasearch engine, providing web search functionality for AI assistants. It supports zero-configuration use of public instances or connection to private instances, with features such as customizable search parameters, multi-search engine support, and privacy-first.

Search tools Artificial intelligence chatbots #Privacy search #AI tools #Web search #Zero-configuration Remote .JavaScript

rating : 2.5 points

downloads : 37

update time : 2025-04-29

What is SearXNG MCP Server?

SearXNG MCP Server is a bridge service that connects AI assistants with the SearXNG metasearch engine. It allows your AI assistant (such as Claude) to perform web searches through simple commands while respecting user privacy.

How to use SearXNG MCP Server?

You can choose the zero-configuration mode to automatically use public search instances or configure your own private SearXNG instance. After installation, simply add the MCP server configuration to your AI assistant settings to start using it.

Use cases

It is particularly useful when you need your AI assistant to obtain the latest web information, such as: - Research on the latest technological developments - Find factual information - Get news and information - Conduct academic research

Main features

Zero-configuration useAutomatically use random public SearXNG instances without any settings

Private instance supportConfigurable to connect to your own SearXNG instance, supporting basic authentication

Privacy protectionConduct searches through SearXNG to protect your search privacy

Multi-search engine supportSpecify a particular search engine to obtain results

Markdown format resultsReturn formatted search results for easy reading and processing

Advantages and limitations

Advantages

Ready to use out of the box without complex configuration

Respect user privacy and do not record search history

Support customization of multiple search parameters

Can be integrated with multiple AI assistants

Limitations

Public instances may be unstable or return a 429 error

Require a Node.js runtime environment

Private instances need to be maintained by yourself

How to use

Installation preparation

Ensure that Node.js (v16+) and npm (v7+) are installed

Install the server

Clone the repository and install dependencies

Configuration (optional)

If you need to use a private instance, create an.env file to configure the URL and authentication information

Run the server

Start the MCP server

AI assistant integration

Add the MCP server configuration to your AI assistant settings

Usage examples

Basic searchPerform a simple web search

Advanced searchPerform a precise search using advanced parameters

Multi-category searchSearch in multiple categories simultaneously

Frequently Asked Questions

Why do I sometimes receive a 429 error?

How can I improve the accuracy of search results?

Does it support Chinese search?

How do I deploy my own SearXNG instance?

Related resources

SearXNG official repository

Source code of the SearXNG metasearch engine

SearX.space

List of public SearXNG instances

MCP protocol documentation

Technical specification of the Model Context Protocol

🚀 SearXNG MCP Server

A server implementing the Model Context Protocol (MCP) that enables you to perform web searches through SearXNG, a privacy-respecting metasearch engine.

🚀 Quick Start

The SearXNG MCP Server allows you to leverage SearXNG for web searches. Here's a quick overview of how to get started.

✨ Features

Multilingual Support: Search based on specified language codes.
Time Range Filtering: Select search results from the last day, week, month, or year.
Category Filtering: Search within preset categories such as general, news, etc.
Engine Customization: Specify a particular search engine to use.
Safe Search: Provide different levels of safe search options, including off, moderate, and strict modes.
Pagination Support: Choose different result pages as needed.
Result Quantity Control: Limit the maximum number of search results returned.

📦 Installation

Environment Requirements

Node.js version 14 or higher
npm version 6 or higher

Clone the Repository

git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

Install Dependencies

npm install

📚 Documentation

Configuration

Configure the server via environment variables:

Property	Details
SEARXNG_INSTANCE	SearXNG instance URL. Default: `http://127.0.0.1:80`
PORT	MCP service listening port. Default: `3000`

💻 Usage Examples

Testing via MCP Inspector

npm run inspector

Open your browser and visit http://localhost:3000. Then, select the SearXNG Search tool on the Inspector interface for testing.

Tool Interface - searxngsearch

Perform web searches using SearXNG. Supports customizing multiple search parameters.

Parameter Description

Parameter Name	Type	Description	Default Value	Required
query	string	Search keywords	-	Yes
language	string	Search result language code (e.g., 'zh', 'en', 'fr')	'zh'	No
time_range	string	Time range filtering. Available values: 'day', 'week', 'month', 'year'	null	No
categories	array	Search categories, e.g., ['General', 'News']	null	No
engines	array	List of specific search engines	null	No
safesearch	number	Safe search level. 0 (off), 1 (moderate), 2 (strict)	1	No
pageno	number	Result page number, starting from 1	1	No
max_results	number	Maximum number of results to return, range 1 - 50	10	No

Example Request

// Example request
const result = await client.callTool('searxngsearch', {
  query: '人工智能',
  language: 'zh',
  time_range: 'week',
  categories: ['通用', '新闻'],
  safesearch: 1,
  max_results: 5
});

🚧 Development Guide

Quick Start

# Clone the repository
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Development mode (live updates)
npm run watch