mcp-searxng 0.3.0 → 0.3.6

package/README.md

@@ -19,12 +19,17 @@ An [MCP server](https://modelcontextprotocol.io/introduction) implementation tha
 - **searxng_web_search**
   - Execute web searches with pagination
   - Inputs:
-    - `query` (string): Search terms
+    - `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)
 
+- **web_url_read**
+  - Read and convert the content from a URL to markdown
+  - Inputs:
+    - `url` (string): The URL to fetch and process
+
 ## Configuration
 
 ### Setting the SEARXNG_URL
@@ -85,7 +90,36 @@ And then in your MCP config file:
 
 ### Docker
 
-#### Build
+#### Using Pre-built Image from Docker Hub
+
+```bash
+docker pull isokoliuk/mcp-searxng:latest
+```
+
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "searxng": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "SEARXNG_URL",
+        "isokoliuk/mcp-searxng:latest"
+      ],
+      "env": {
+        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
+      }
+    }
+  }
+}
+```
+
+#### Build Locally
 
 ```bash
 docker build -t mcp-searxng:latest -f Dockerfile .

package/dist/index.js

@@ -3,6 +3,11 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { NodeHtmlMarkdown } from "node-html-markdown";
+import { readFileSync } from "fs";
+import { join } from "path";
+// Read package.json to get the version
+const packageJson = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf-8"));
+const packageVersion = packageJson.version;
 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. " +
@@ -12,7 +17,7 @@ const WEB_SEARCH_TOOL = {
         properties: {
             query: {
                 type: "string",
-                description: "Search query",
+                description: "The search query. This is the main input for the web search",
             },
             pageno: {
                 type: "number",
@@ -58,11 +63,20 @@ const READ_URL_TOOL = {
 // Server implementation
 const server = new Server({
     name: "ihor-sokoliuk/mcp-searxng",
-    version: "0.3.0",
+    version: packageVersion,
 }, {
     capabilities: {
         resources: {},
-        tools: {},
+        tools: {
+            searxng_web_search: {
+                description: WEB_SEARCH_TOOL.description,
+                schema: WEB_SEARCH_TOOL.inputSchema,
+            },
+            web_url_read: {
+                description: READ_URL_TOOL.description,
+                schema: READ_URL_TOOL.inputSchema,
+            },
+        },
     },
 });
 function isSearXNGWebSearchArgs(args) {
@@ -146,7 +160,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.3.0",
+    "version": "0.3.6",
     "description": "MCP server for SearXNG integration",
     "license": "MIT",
     "author": "Ihor Sokoliuk (https://github.com/ihor-sokoliuk)",
@@ -13,18 +13,21 @@
     "files": [
         "dist"
     ],
+    "engines": {
+        "node": ">=18"
+    },
     "scripts": {
         "build": "tsc && shx chmod +x dist/*.js",
         "prepare": "npm run build",
         "watch": "tsc --watch"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk": "1.9.0",
+        "@modelcontextprotocol/sdk": "1.10.1",
         "node-html-markdown": "^1.3.0"
     },
     "devDependencies": {
         "@types/node": "^22.14.1",
-        "shx": "^0.3.4",
-        "typescript": "^5.7.2"
+        "shx": "^0.4.0",
+        "typescript": "^5.8.3"
     }
 }