mcp-searxng 0.2.1 → 0.3.0

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,7 +9,10 @@ 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
 
@@ -17,8 +20,10 @@ An [MCP server](https://modelcontextprotocol.io/introduction) implementation tha
   - 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)
+    - `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
 
@@ -38,19 +43,17 @@ To install SearxNG Server for Claude Desktop automatically via [Smithery](https:
 npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude
 ```
 
-### Installing via npm
-
-```bash
-npm install -g mcp-searxng
-```
-
-And then in your MCP config file:
+### NPX
 
 ```json
 {
   "mcpServers": {
     "searxng": {
-      "command": "mcp-searxng",
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-searxng"
+      ],
       "env": {
         "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
       }
@@ -59,17 +62,19 @@ And then in your MCP config file:
 }
 ```
 
-### NPX
+### NPM
+
+```bash
+npm install -g mcp-searxng
+```
+
+And then in your MCP config file:
 
 ```json
 {
   "mcpServers": {
     "searxng": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "mcp-searxng"
-      ],
+      "command": "mcp-searxng",
       "env": {
         "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
       }
@@ -101,7 +106,7 @@ Add this to your `claude_desktop_config.json`:
         "--rm",
         "-e",
         "SEARXNG_URL",
-        "mcp-server-searxng:latest"
+        "mcp-searxng:latest"
       ],
       "env": {
         "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"

package/dist/index.js

@@ -14,15 +14,27 @@ const WEB_SEARCH_TOOL = {
                 type: "string",
                 description: "Search query",
             },
-            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"],
@@ -45,8 +57,8 @@ const READ_URL_TOOL = {
 };
 // Server implementation
 const server = new Server({
-    name: "example-servers/searxng-search",
-    version: "0.1.0",
+    name: "ihor-sokoliuk/mcp-searxng",
+    version: "0.3.0",
 }, {
     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.1",
+    "version": "0.3.0",
     "description": "MCP server for SearXNG integration",
     "license": "MIT",
     "author": "Ihor Sokoliuk (https://github.com/ihor-sokoliuk)",