@kassol/mcp-searxng 1.0.3-custom.1 → 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_BASE64`:
+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
 {
@@ -221,12 +231,16 @@ Protected SearXNG instances can receive extra search request headers through `SE
 }
 ```
 
-Generate that value with:
+ChatWise environment variables:
 
-```bash
-node -e 'console.log(Buffer.from(JSON.stringify({"CF-Access-Client-Id":"your-client-id.access","CF-Access-Client-Secret":"your-client-secret"})).toString("base64"))'
+```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/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.1";
+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.1";
+const packageVersion = "1.1.0";
 // Export the version for use in other modules
 export { packageVersion };
 // Type guard for URL reading args

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kassol/mcp-searxng",
-    "version": "1.0.3-custom.1",
+    "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": {