qingflow-mcp 0.2.1 → 0.2.2

package/README.md

@@ -14,6 +14,10 @@ It intentionally excludes delete for now.
 
 ## Setup
 
+Runtime requirement:
+
+- Node.js `>=18`
+
 1. Install dependencies:
 
 ```bash
@@ -56,6 +60,12 @@ Global install from GitHub:
 npm i -g git+https://github.com/853046310/qingflow-mcp.git
 ```
 
+Install latest from npm:
+
+```bash
+npm i -g qingflow-mcp@latest
+```
+
 Or one-click installer:
 
 ```bash
@@ -107,6 +117,23 @@ export QINGFLOW_LIST_MAX_ITEMS_WITH_ANSWERS=5
 export QINGFLOW_LIST_MAX_ITEMS_BYTES=400000
 ```
 
+## Troubleshooting
+
+If you see runtime errors around `Headers` or missing web APIs:
+
+1. Upgrade Node to `>=18`.
+2. Upgrade package to latest:
+
+```bash
+npm i -g qingflow-mcp@latest
+```
+
+3. Verify runtime:
+
+```bash
+node -e "console.log(process.version, typeof fetch, typeof Headers)"
+```
+
 ## Publish
 
 ```bash

package/dist/qingflow-client.js

@@ -88,24 +88,25 @@ export class QingflowClient {
         const options = params.options ?? {};
         const url = new URL(params.path, this.baseUrl);
         appendQuery(url, options.query);
-        const headers = new Headers();
-        headers.set("accessToken", this.accessToken);
+        const headers = {
+            accessToken: this.accessToken
+        };
         if (options.userId) {
-            headers.set("userId", options.userId);
+            headers.userId = options.userId;
         }
         const init = {
             method: params.method,
             headers
         };
         if (options.body !== undefined) {
-            headers.set("content-type", "application/json");
+            headers["content-type"] = "application/json";
             init.body = JSON.stringify(options.body);
         }
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeoutMs);
         init.signal = controller.signal;
         try {
-            const response = await fetch(url, init);
+            const response = await getFetch()(url, init);
             const text = await response.text();
             const data = safeJsonParse(text);
             if (!response.ok) {
@@ -253,3 +254,12 @@ function toFiniteNumber(value) {
     }
     return null;
 }
+function getFetch() {
+    const runtimeFetch = globalThis.fetch;
+    if (typeof runtimeFetch === "function") {
+        return runtimeFetch.bind(globalThis);
+    }
+    throw new QingflowApiError({
+        message: "Global fetch is not available. Use Node.js >= 18."
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qingflow-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,9 @@
     "start": "node dist/server.js",
     "prepublishOnly": "npm run build"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.4",
     "zod": "^3.25.76"