MCP Searxng

🚀 SearXNG MCP Server

An implementation of the MCP Server that integrates the SearXNG API to provide web search functionality.

🚀 Quick Start

The SearXNG MCP Server integrates the SearXNG API to offer web search capabilities, including features like pagination, time filtering, language selection, and safe search.

✨ Features

• Web Search: Supports general queries, news, and articles with pagination.
• Pagination: Control the number of result pages to retrieve (starting from 1).
• Time Filtering: Filter results by time period (day, month, year).
• Language Selection: Filter results by language code (e.g., "en", "fr", "de") or set to "all".
• Safe Search: Control the content filtering level (0: None, 1: Moderate, 2: Strict).

🛠️ Tools

searxng_web_search

• Perform a web search with pagination.
• Input:
  • query (string): The search query. This string is passed to the external search engine.
  • pageno (number, optional): The page number of the search results, starting from 1 (default: 1).
  • time_range (string, optional): Filter results by time period. Available values are "day", "month", "year" (default: None).
  • language (string, optional): The language code of the results (e.g., "en", "fr", "de") or "all" (default: all languages).
  • safesearch (number, optional): The safe search filtering level (0: None, 1: Moderate, 2: Strict) (default: instance settings).

web_url_read

• Fetch and convert content from a URL to Markdown format.
• Input:
  • url (string): The URL to fetch and process.

⚙️ Configuration

Set the SEARXNG_URL Environment Variable

To make the MCP server work properly, you need to set the following environment variable:

SEARXNG_URL=http://localhost:8080

This tells the server how to communicate with the SearXNG instance.

📦 Installation

Install with NPM

You can use the Node Package Manager (NPM) to install and run the MCP server:

npm install -g searxng-mcp-server
searxng-mcp-server start

Run with NPX

You can also directly use NPX to run the MCP server without pre - installation:

npx searxng-mcp-server start

Install with Docker

To install and run the MCP server using Docker, execute the following commands:

docker pull searxng/mcp-server:latest
docker run -e SEARXNG_URL=http://localhost:8080 -p 8000:8000 searxng/mcp-server:latest

Configure on Claude Desktop

To configure the MCP server on Claude Desktop, follow these steps:

1. Open Claude Desktop.
2. Go to Settings > Extensions.
3. Search for and install the "SearXNG MCP Server" extension.
4. After installation, restart Claude Desktop.

📄 License

This MCP server is released 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 refer to the LICENSE file in the project repository.