mcp-searxng 0.4.5 → 0.5.0

package/README.md

@@ -38,6 +38,13 @@ An [MCP server](https://modelcontextprotocol.io/introduction) implementation tha
 2. Set the `SEARXNG_URL` environment variable to the instance URL.
 3. The default `SEARXNG_URL` value is `http://localhost:8080`.
 
+### Using Authentication
+
+If you are using a password protected SearxNG instance you can set a username and password for HTTP Basic Auth:
+
+- Set the `AUTH_USERNAME` environmental variable to your username
+- Set the `AUTH_PASSWORD` environmental variable to your password
+
 ### Usage with Claude Desktop
 
 ### Installing via Smithery

package/dist/index.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { NodeHtmlMarkdown } from "node-html-markdown";
 // Use a static version string that will be updated by the version script
-const packageVersion = "0.4.4";
+const packageVersion = "0.5.0";
 const WEB_SEARCH_TOOL = {
     name: "searxng_web_search",
     description: "Performs a web search using the SearXNG API, ideal for general queries, news, articles, and online content. " +
@@ -24,8 +24,7 @@ const WEB_SEARCH_TOOL = {
             time_range: {
                 type: "string",
                 description: "Time range of search (day, month, year)",
-                enum: ["", "day", "month", "year"],
-                default: "",
+                enum: ["day", "month", "year"],
             },
             language: {
                 type: "string",
@@ -33,10 +32,10 @@ const WEB_SEARCH_TOOL = {
                 default: "all",
             },
             safesearch: {
-                type: "number",
+                type: "string",
                 description: "Safe search filter level (0: None, 1: Moderate, 2: Strict)",
-                enum: [0, 1, 2],
-                default: undefined,
+                enum: ["0", "1", "2"],
+                default: "0",
             },
         },
         required: ["query"],
@@ -82,24 +81,37 @@ function isSearXNGWebSearchArgs(args) {
         "query" in args &&
         typeof args.query === "string");
 }
-async function performWebSearch(query, pageno = 1, time_range = "", language = "all", safesearch) {
+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("pageno", pageno.toString());
-    if (time_range && ["day", "month", "year"].includes(time_range)) {
+    if (time_range !== undefined &&
+        ["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());
+    if (safesearch !== undefined && ["0", "1", "2"].includes(safesearch)) {
+        url.searchParams.set("safesearch", safesearch);
+    }
+    // Prepare request options with headers
+    const requestOptions = {
+        method: "GET"
+    };
+    // Add basic authentication if credentials are provided
+    const username = process.env.AUTH_USERNAME;
+    const password = process.env.AUTH_PASSWORD;
+    if (username && password) {
+        const base64Auth = Buffer.from(`${username}:${password}`).toString('base64');
+        requestOptions.headers = {
+            ...requestOptions.headers,
+            'Authorization': `Basic ${base64Auth}`
+        };
     }
-    const response = await fetch(url.toString(), {
-        method: "GET",
-    });
+    const response = await fetch(url.toString(), requestOptions);
     if (!response.ok) {
         throw new Error(`SearXNG API error: ${response.status} ${response.statusText}\n${await response.text()}`);
     }
@@ -157,7 +169,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (!isSearXNGWebSearchArgs(args)) {
                 throw new Error("Invalid arguments for searxng_web_search");
             }
-            const { query, pageno = 1, time_range = "", language = "all", safesearch, } = args;
+            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 }],

package/package.json

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