@aborruso/ckan-mcp-server 0.4.31 → 0.4.33

package/AGENTS.md

@@ -45,6 +45,13 @@ Keep this managed block so 'openspec update' can refresh the instructions.
 
 **Single test**: `npm test -- tests/unit/http.test.ts` | `npm test -- -t "testName"`
 
+## Local MCP Client Build Test
+
+Before deploying, you can test the current dev build by pointing your MCP client at the Node entrypoint in `dist/`:
+
+1. Build: `npm run build`
+2. Example absolute path: `/home/aborruso/git/idee/ckan-mcp-server/dist/index.js` (adjust to your local checkout)
+
 ## GitHub CLI Notes
 
 When creating issues with multi-line bodies, avoid literal `\n` in `--body`. Use a here-doc

package/LOG.md

@@ -2,6 +2,16 @@
 
 ## 2026-02-01
 
+### Release v0.4.33
+
+- Docs: clarify natural language date-field mapping for package search and document `content_recent` usage with example
+- Files: `src/tools/package.ts`, `src/server.ts`, `src/worker.ts`, `package.json`, `package-lock.json`
+
+### Release v0.4.32
+
+- Workers: align browser-like headers for fetch path to avoid 403 on dati.gov.it
+- Files: `src/utils/http.ts`, `package.json`, `package-lock.json`
+
 ### Release v0.4.31
 
 - Workers: decode compressed responses via DecompressionStream when available

package/dist/index.js

@@ -142,12 +142,49 @@ function asBuffer(data) {
   }
   return void 0;
 }
+function asArrayBuffer(data) {
+  if (!data) {
+    return void 0;
+  }
+  if (data instanceof ArrayBuffer) {
+    return data;
+  }
+  if (ArrayBuffer.isView(data)) {
+    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+  }
+  return void 0;
+}
+async function decodeArrayBufferText(buffer, encoding) {
+  if (encoding && typeof DecompressionStream !== "undefined") {
+    try {
+      const stream = new DecompressionStream(
+        encoding.includes("br") ? "br" : encoding.includes("deflate") ? "deflate" : "gzip"
+      );
+      const decompressed = await new Response(
+        new Blob([buffer]).stream().pipeThrough(stream)
+      ).arrayBuffer();
+      return new TextDecoder("utf-8").decode(decompressed).trim();
+    } catch {
+    }
+  }
+  return new TextDecoder("utf-8").decode(buffer).trim();
+}
 async function decodePossiblyCompressed(data, headers) {
   if (data === null || data === void 0) {
     return data;
   }
-  if (typeof data === "object" && !asBuffer(data)) {
-    return data;
+  const arrayBuffer = asArrayBuffer(data);
+  if (arrayBuffer && typeof Buffer === "undefined") {
+    const encoding2 = getHeaderValue(headers, "content-encoding");
+    const text2 = await decodeArrayBufferText(arrayBuffer, encoding2);
+    if (!text2) {
+      return text2;
+    }
+    try {
+      return JSON.parse(text2);
+    } catch {
+      return text2;
+    }
   }
   if (typeof data === "string") {
     try {
@@ -158,6 +195,9 @@ async function decodePossiblyCompressed(data, headers) {
   }
   const buffer = asBuffer(data);
   if (!buffer) {
+    if (typeof data === "object") {
+      return data;
+    }
     return data;
   }
   const encoding = getHeaderValue(headers, "content-encoding");
@@ -241,7 +281,18 @@ async function makeCkanRequest(serverUrl, action, params = {}) {
         method: "GET",
         headers: {
           Accept: "application/json, text/plain, */*",
-          "Accept-Language": "en-US,en;q=0.9,it;q=0.8"
+          "Accept-Language": "en-US,en;q=0.9,it;q=0.8",
+          "Accept-Encoding": "gzip, deflate, br",
+          Connection: "keep-alive",
+          Referer: `${baseUrl}/`,
+          "Sec-Fetch-Site": "same-origin",
+          "Sec-Fetch-Mode": "navigate",
+          "Sec-Fetch-Dest": "document",
+          "Upgrade-Insecure-Requests": "1",
+          "Sec-CH-UA": '"Chromium";v="120", "Not?A_Brand";v="24", "Google Chrome";v="120"',
+          "Sec-CH-UA-Mobile": "?0",
+          "Sec-CH-UA-Platform": '"Linux"',
+          "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
         }
       });
       if (!response.ok) {
@@ -668,6 +719,11 @@ Important - Date field semantics:
   - metadata_modified: CKAN record update timestamp (publish time on source portals,
     harvest time on aggregators; use for "updated/modified in last X")
 
+Natural language mapping (important for tool callers):
+  - "created"/"published" -> prefer issued; fallback to metadata_created
+  - "updated"/"modified" -> prefer modified; fallback to metadata_modified
+  - For "recent in last X", consider using content_recent (issued with metadata_created fallback)
+
 Content-recent helper:
   - content_recent: if true, rewrites the query to use issued with a fallback to
     metadata_created when issued is missing.
@@ -743,6 +799,7 @@ Examples:
   - Date range: { q: "metadata_modified:[2024-01-01T00:00:00Z TO 2024-12-31T23:59:59Z]" }
   - Date math: { q: "metadata_modified:[NOW-6MONTHS TO *]" }
   - Date math (auto-converted): { q: "modified:[NOW-30DAYS TO NOW]" }
+  - Recent content (issued w/ fallback): { q: "*:*", content_recent: true, content_recent_days: 180 }
   - Field exists: { q: "organization:* AND num_resources:[1 TO *]" }
   - Boosting: { q: "title:climate^2 OR notes:climate" }
   - Filter org: { fq: "organization:regione-siciliana" }
@@ -3346,7 +3403,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.27"
+    version: "0.4.33"
   });
 }
 function registerAll(server2) {