mcp-searxng 0.2.2 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # SearXNG MCP Server
 
-An [MCP server](https://modelcontextprotocol.io/introduction) implementation that integrates the SearxNG API, providing web search capabilities.
+An [MCP server](https://modelcontextprotocol.io/introduction) implementation that integrates the [SearXNG](https://docs.searxng.org) API, providing web search capabilities.
 
 <a href="https://glama.ai/mcp/servers/0j7jjyt7m9"><img width="380" height="200" src="https://glama.ai/mcp/servers/0j7jjyt7m9/badge" alt="SearXNG Server MCP server" /></a>
 
@@ -9,16 +9,21 @@ An [MCP server](https://modelcontextprotocol.io/introduction) implementation tha
 ## Features
 
 - **Web Search**: General queries, news, articles, with pagination.
-- **Pagination**: Control return size and result counts options.
+- **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): Search terms
-    - `count` (number, optional): Results per page (default 20)
-    - `offset` (number, optional): Pagination offset (default 0)
+    - `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)
 
 ## Configuration
 

package/dist/index.js

@@ -12,17 +12,29 @@ const WEB_SEARCH_TOOL = {
         properties: {
             query: {
                 type: "string",
-                description: "Search query",
+                description: "The search query. This string is passed to external search services.",
             },
-            count: {
+            pageno: {
                 type: "number",
-                description: "Number of results",
-                default: 20,
+                description: "Search page number (starts at 1)",
+                default: 1,
             },
-            offset: {
+            time_range: {
+                type: "string",
+                description: "Time range of search (day, month, year)",
+                enum: ["", "day", "month", "year"],
+                default: "",
+            },
+            language: {
+                type: "string",
+                description: "Language code for search results (e.g., 'en', 'fr', 'de'). Default is instance-dependent.",
+                default: "all",
+            },
+            safesearch: {
                 type: "number",
-                description: "Pagination offset",
-                default: 0,
+                description: "Safe search filter level (0: None, 1: Moderate, 2: Strict)",
+                enum: [0, 1, 2],
+                default: undefined,
             },
         },
         required: ["query"],
@@ -46,7 +58,7 @@ const READ_URL_TOOL = {
 // Server implementation
 const server = new Server({
     name: "ihor-sokoliuk/mcp-searxng",
-    version: "0.2.2",
+    version: "0.3.1",
 }, {
     capabilities: {
         resources: {},
@@ -59,13 +71,21 @@ function isSearXNGWebSearchArgs(args) {
         "query" in args &&
         typeof args.query === "string");
 }
-async function performWebSearch(query, count = 10, offset = 0) {
+async function performWebSearch(query, pageno = 1, time_range = "", language = "all", safesearch) {
     const searxngUrl = process.env.SEARXNG_URL || "http://localhost:8080";
     const url = new URL(`${searxngUrl}/search`);
     url.searchParams.set("q", query);
     url.searchParams.set("format", "json");
-    url.searchParams.set("start", offset.toString());
-    url.searchParams.set("count", count.toString());
+    url.searchParams.set("pageno", pageno.toString());
+    if (time_range && ["day", "month", "year"].includes(time_range)) {
+        url.searchParams.set("time_range", time_range);
+    }
+    if (language && language !== "all") {
+        url.searchParams.set("language", language);
+    }
+    if (safesearch !== undefined && [0, 1, 2].includes(safesearch)) {
+        url.searchParams.set("safesearch", safesearch.toString());
+    }
     const response = await fetch(url.toString(), {
         method: "GET",
     });
@@ -126,8 +146,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (!isSearXNGWebSearchArgs(args)) {
                 throw new Error("Invalid arguments for searxng_web_search");
             }
-            const { query, count = 10 } = args;
-            const results = await performWebSearch(query, count);
+            const { query, pageno = 1, time_range = "", language = "all", safesearch, } = args;
+            const results = await performWebSearch(query, pageno, time_range, language, safesearch);
             return {
                 content: [{ type: "text", text: results }],
                 isError: false,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mcp-searxng",
-    "version": "0.2.2",
+    "version": "0.3.1",
     "description": "MCP server for SearXNG integration",
     "license": "MIT",
     "author": "Ihor Sokoliuk (https://github.com/ihor-sokoliuk)",