@kassol/mcp-searxng 1.0.3-custom.0 → 1.1.0

package/README.md

@@ -2,13 +2,12 @@
 
 An [MCP server](https://modelcontextprotocol.io/introduction) that integrates the [SearXNG](https://docs.searxng.org) API, giving AI assistants web search capabilities.
 
-This fork is published as `@kassol/mcp-searxng` and includes support for custom outgoing headers via `SEARXNG_HEADERS` and `URL_READER_HEADERS`.
+This fork is published as `@kassol/mcp-searxng` and includes support for custom outgoing headers via `SEARXNG_HEADERS`, `URL_READER_HEADERS`, and their base64 variants.
 
-[![https://nodei.co/npm/mcp-searxng.png?downloads=true&downloadRank=true&stars=true](https://nodei.co/npm/mcp-searxng.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/mcp-searxng)
-
-[![https://badgen.net/docker/pulls/isokoliuk/mcp-searxng](https://badgen.net/docker/pulls/isokoliuk/mcp-searxng)](https://hub.docker.com/r/isokoliuk/mcp-searxng)
-
-<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>
+[![npm version](https://img.shields.io/npm/v/%40kassol%2Fmcp-searxng?label=npm)](https://www.npmjs.com/package/@kassol/mcp-searxng)
+[![npm downloads](https://img.shields.io/npm/dm/%40kassol%2Fmcp-searxng)](https://www.npmjs.com/package/@kassol/mcp-searxng)
+[![license](https://img.shields.io/npm/l/%40kassol%2Fmcp-searxng)](LICENSE)
+[![GitHub repo](https://img.shields.io/badge/github-kassol%2Fmcp--searxng-24292f?logo=github)](https://github.com/kassol/mcp-searxng)
 
 ## Quick Start
 
@@ -102,12 +101,10 @@ npm install -g @kassol/mcp-searxng
 </details>
 
 <details>
-<summary>Docker</summary>
-
-**Pre-built image:**
+<summary>Docker (local build)</summary>
 
 ```bash
-docker pull isokoliuk/mcp-searxng:latest
+docker build -t mcp-searxng:latest -f Dockerfile .
 ```
 
 ```json
@@ -118,7 +115,7 @@ docker pull isokoliuk/mcp-searxng:latest
       "args": [
         "run", "-i", "--rm",
         "-e", "SEARXNG_URL",
-        "isokoliuk/mcp-searxng:latest"
+        "mcp-searxng:latest"
       ],
       "env": {
         "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
@@ -130,14 +127,6 @@ docker pull isokoliuk/mcp-searxng:latest
 
 To pass additional env vars, add `-e VAR_NAME` to `args` and the variable to `env`.
 
-**Build locally:**
-
-```bash
-docker build -t mcp-searxng:latest -f Dockerfile .
-```
-
-Use the same config above, replacing `isokoliuk/mcp-searxng:latest` with `mcp-searxng:latest`.
-
 </details>
 
 <details>
@@ -148,7 +137,10 @@ Use the same config above, replacing `isokoliuk/mcp-searxng:latest` with `mcp-se
 ```yaml
 services:
   mcp-searxng:
-    image: isokoliuk/mcp-searxng:latest
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: mcp-searxng:latest
     stdin_open: true
     environment:
       - SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL
@@ -161,8 +153,8 @@ MCP client config:
 {
   "mcpServers": {
     "searxng": {
-      "command": "docker-compose",
-      "args": ["run", "--rm", "mcp-searxng"]
+      "command": "docker",
+      "args": ["compose", "run", "--rm", "mcp-searxng"]
     }
   }
 }
@@ -204,7 +196,25 @@ curl http://localhost:3000/health
 
 Set `SEARXNG_URL` to your SearXNG instance URL. All other variables are optional.
 
-Protected SearXNG instances can receive extra search request headers through `SEARXNG_HEADERS`:
+Protected SearXNG instances can receive extra search request headers through `SEARXNG_HEADERS_BASE64`. This is the recommended format for ChatWise and other MCP clients that treat environment variables as plain key-value fields.
+
+Generate the value directly from existing Cloudflare Access environment variables:
+
+```bash
+export CF_ACCESS_CLIENT_ID='your-client-id.access'
+export CF_ACCESS_CLIENT_SECRET='your-client-secret'
+
+node -e 'console.log(Buffer.from(JSON.stringify({"CF-Access-Client-Id":process.env.CF_ACCESS_CLIENT_ID,"CF-Access-Client-Secret":process.env.CF_ACCESS_CLIENT_SECRET})).toString("base64"))'
+```
+
+Verify the generated value:
+
+```bash
+export SEARXNG_HEADERS_BASE64='paste-generated-value-here'
+node -e 'console.log(Buffer.from(process.env.SEARXNG_HEADERS_BASE64,"base64").toString("utf8"))'
+```
+
+MCP client configuration:
 
 ```json
 {
@@ -214,13 +224,23 @@ Protected SearXNG instances can receive extra search request headers through `SE
       "args": ["-y", "@kassol/mcp-searxng"],
       "env": {
         "SEARXNG_URL": "https://search.example.com",
-        "SEARXNG_HEADERS": "{\"CF-Access-Client-Id\":\"your-client-id.access\",\"CF-Access-Client-Secret\":\"your-client-secret\"}"
+        "SEARXNG_HEADERS_BASE64": "eyJDRi1BY2Nlc3MtQ2xpZW50LUlkIjoieW91ci1jbGllbnQtaWQuYWNjZXNzIiwiQ0YtQWNjZXNzLUNsaWVudC1TZWNyZXQiOiJ5b3VyLWNsaWVudC1zZWNyZXQifQ=="
       }
     }
   }
 }
 ```
 
+ChatWise environment variables:
+
+```text
+SEARXNG_URL=https://search.example.com
+USER_AGENT=Mozilla/5.0
+SEARXNG_HEADERS_BASE64=paste-generated-value-here
+```
+
+`SEARXNG_HEADERS_BASE64` applies only to `searxng_web_search` requests. Use `URL_READER_HEADERS_BASE64` for headers that should be sent by `web_url_read`.
+
 Full environment variable reference: [CONFIGURATION.md](CONFIGURATION.md)
 
 ## Troubleshooting

package/dist/headers.d.ts

@@ -1,3 +1,6 @@
 export type HeaderRecord = Record<string, string>;
 export declare function parseHeadersFromEnv(envVarName: string): HeaderRecord;
+export declare function parseHeadersFromBase64Env(envVarName: string): HeaderRecord;
+export declare function getSearxngHeadersFromEnv(): HeaderRecord;
+export declare function getUrlReaderHeadersFromEnv(): HeaderRecord;
 export declare function mergeHeaders(headers: HeadersInit | undefined, additionalHeaders: HeaderRecord): HeaderRecord;

package/dist/headers.js

@@ -47,6 +47,23 @@ export function parseHeadersFromEnv(envVarName) {
     if (!rawHeaders) {
         return createHeaderRecord();
     }
+    return parseHeadersJson(rawHeaders, envVarName);
+}
+export function parseHeadersFromBase64Env(envVarName) {
+    const rawHeaders = process.env[envVarName];
+    if (!rawHeaders) {
+        return createHeaderRecord();
+    }
+    let decodedHeaders;
+    try {
+        decodedHeaders = Buffer.from(rawHeaders, "base64").toString("utf8");
+    }
+    catch {
+        throw createConfigurationError(`${envVarName} must be valid base64`);
+    }
+    return parseHeadersJson(decodedHeaders, envVarName);
+}
+function parseHeadersJson(rawHeaders, envVarName) {
     let parsedHeaders;
     try {
         parsedHeaders = JSON.parse(rawHeaders);
@@ -68,6 +85,15 @@ export function parseHeadersFromEnv(envVarName) {
     }
     return headers;
 }
+export function getSearxngHeadersFromEnv() {
+    return getHeadersFromEnv("SEARXNG_HEADERS", "SEARXNG_HEADERS_BASE64");
+}
+export function getUrlReaderHeadersFromEnv() {
+    return getHeadersFromEnv("URL_READER_HEADERS", "URL_READER_HEADERS_BASE64");
+}
+function getHeadersFromEnv(jsonEnvVarName, base64EnvVarName) {
+    return mergeHeaders(parseHeadersFromEnv(jsonEnvVarName), parseHeadersFromBase64Env(base64EnvVarName));
+}
 export function mergeHeaders(headers, additionalHeaders) {
     const mergedHeaders = normalizeHeaders(headers);
     for (const [name, value] of Object.entries(additionalHeaders)) {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-declare const packageVersion = "1.0.3-custom.0";
+declare const packageVersion = "1.1.0";
 export { packageVersion };
 export declare function isWebUrlReadArgs(args: unknown): args is {
     url: string;

package/dist/index.js

@@ -10,7 +10,7 @@ import { fetchAndConvertToMarkdown } from "./url-reader.js";
 import { createConfigResource, createHelpResource } from "./resources.js";
 import { createHttpServer } from "./http-server.js";
 // Use a static version string that will be updated by the version script
-const packageVersion = "1.0.3-custom.0";
+const packageVersion = "1.1.0";
 // Export the version for use in other modules
 export { packageVersion };
 // Type guard for URL reading args

package/dist/resources.js

@@ -15,8 +15,8 @@ export function createConfigResource() {
                 ? { searxngUrl: process.env.SEARXNG_URL || "(not configured)" }
                 : { searxngUrlConfigured: !!process.env.SEARXNG_URL }),
             hasAuth: !!(process.env.AUTH_USERNAME && process.env.AUTH_PASSWORD),
-            hasSearxngHeaders: !!process.env.SEARXNG_HEADERS,
-            hasUrlReaderHeaders: !!process.env.URL_READER_HEADERS,
+            hasSearxngHeaders: !!(process.env.SEARXNG_HEADERS || process.env.SEARXNG_HEADERS_BASE64),
+            hasUrlReaderHeaders: !!(process.env.URL_READER_HEADERS || process.env.URL_READER_HEADERS_BASE64),
             hasProxy: !!(process.env.HTTP_PROXY || process.env.HTTPS_PROXY || process.env.http_proxy || process.env.https_proxy),
             hasNoProxy: !!(process.env.NO_PROXY || process.env.no_proxy),
             nodeVersion: process.version,
@@ -65,7 +65,9 @@ Reads and converts web page content to Markdown format.
 - \`USER_AGENT\`: Global User-Agent header for outgoing requests
 - \`URL_READER_USER_AGENT\`: User-Agent for \`web_url_read\`, overrides \`USER_AGENT\`
 - \`SEARXNG_HEADERS\`: Extra JSON headers for SearXNG search requests
+- \`SEARXNG_HEADERS_BASE64\`: Base64-encoded JSON headers for SearXNG search requests
 - \`URL_READER_HEADERS\`: Extra JSON headers for URL read requests
+- \`URL_READER_HEADERS_BASE64\`: Base64-encoded JSON headers for URL read requests
 - \`HTTP_PROXY\` / \`HTTPS_PROXY\`: Proxy server configuration
 - \`NO_PROXY\` / \`no_proxy\`: Comma-separated list of hosts to bypass proxy
 - \`MCP_HTTP_PORT\`: Enable HTTP transport on specified port

package/dist/search.js

@@ -1,6 +1,6 @@
 import { createProxyAgent, createDefaultAgent, ProxyType } from "./proxy.js";
 import { logMessage } from "./logging.js";
-import { mergeHeaders, parseHeadersFromEnv } from "./headers.js";
+import { getSearxngHeadersFromEnv, mergeHeaders } from "./headers.js";
 import { MCPSearXNGError, validateEnvironment, createNetworkError, createServerError, createJSONError, createDataError, createNoResultsMessage } from "./error-handler.js";
 export async function performWebSearch(mcpServer, query, pageno = 1, time_range, language = "all", safesearch) {
     const startTime = Date.now();
@@ -61,7 +61,7 @@ export async function performWebSearch(mcpServer, query, pageno = 1, time_range,
             'User-Agent': userAgent
         };
     }
-    const additionalHeaders = parseHeadersFromEnv("SEARXNG_HEADERS");
+    const additionalHeaders = getSearxngHeadersFromEnv();
     if (Object.keys(additionalHeaders).length > 0) {
         requestOptions.headers = mergeHeaders(requestOptions.headers, additionalHeaders);
     }

package/dist/url-reader.js

@@ -4,7 +4,7 @@ import { createProxyAgent, createDefaultAgent, ProxyType } from "./proxy.js";
 import { logMessage } from "./logging.js";
 import { urlCache } from "./cache.js";
 import { getHttpSecurityConfig } from "./http-security.js";
-import { mergeHeaders, parseHeadersFromEnv } from "./headers.js";
+import { getUrlReaderHeadersFromEnv, mergeHeaders } from "./headers.js";
 import { createURLFormatError, createURLSecurityPolicyError, createNetworkError, createServerError, createContentError, createConversionError, createTimeoutError, createEmptyContentWarning, createUnexpectedError } from "./error-handler.js";
 function isPrivateHostname(hostname) {
     const lower = hostname.toLowerCase().replace(/\.+$/, "");
@@ -194,7 +194,7 @@ export async function fetchAndConvertToMarkdown(mcpServer, url, timeoutMs = 1000
                 'User-Agent': userAgent
             };
         }
-        const additionalHeaders = parseHeadersFromEnv("URL_READER_HEADERS");
+        const additionalHeaders = getUrlReaderHeadersFromEnv();
         if (Object.keys(additionalHeaders).length > 0) {
             requestOptions.headers = mergeHeaders(requestOptions.headers, additionalHeaders);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kassol/mcp-searxng",
-    "version": "1.0.3-custom.0",
+    "version": "1.1.0",
     "mcpName": "io.github.kassol/mcp-searxng",
     "description": "MCP server for SearXNG integration",
     "license": "MIT",
@@ -45,6 +45,12 @@
         "bootstrap": "npm install && npm run build",
         "inspector": "DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector node dist/index.js",
         "lint": "eslint src __tests__",
+        "sync-version": "node scripts/update-version.js",
+        "release:check": "npm run build && npm run lint && npm test && npm pack --dry-run",
+        "release:dry-run": "npm publish --dry-run --access public --tag latest",
+        "release:patch": "npm version patch",
+        "release:minor": "npm version minor",
+        "release:major": "npm version major",
         "postversion": "TAG=$(node scripts/update-version.js | tail -1) && git add src/index.ts .mcp/server.json && git commit --amend --no-edit && git tag -f $TAG"
     },
     "dependencies": {