@aborruso/ckan-mcp-server 0.4.67 → 0.4.69

package/LOG.md

@@ -1,5 +1,16 @@
 # LOG
 
+## 2026-03-04 (v0.4.69)
+
+- feat: `ckan_package_search` and `ckan_package_show` JSON output now include `view_url` field pointing to the dataset page on the source portal
+
+## 2026-03-04 (v0.4.68)
+
+- feat: SPARQL endpoint config in `portals.json` — `sparql.endpoint_url` + `sparql.method` per portal (Italy: `lod.dati.gov.it/sparql`, GET-only)
+- feat: `ckan_status_show` now shows SPARQL endpoint when configured for the portal
+- fix: `sparql_query` — GET fallback on 403/405 for endpoints that reject POST; User-Agent set to `Mozilla/5.0 (compatible; CKAN-MCP-Server/1.0)` (required by AWS WAF on lod.dati.gov.it)
+- refactor: `portal-config.ts` — added `SparqlConfig` type, `getSparqlConfig(endpointUrl)`, `getPortalSparqlConfig(serverUrl)`; tool count 18→19
+
 ## 2026-03-04 (v0.4.67)
 
 - improve: `sparql_query` — validate SELECT-only, auto-inject LIMIT (default 25, max 1000), truncate output at CHARACTER_LIMIT; +11 tests (310 total)

package/dist/index.js

@@ -37,6 +37,10 @@ var portals_default = {
       hvd: {
         category_field: "hvd_category"
       },
+      sparql: {
+        endpoint_url: "https://lod.dati.gov.it/sparql",
+        method: "GET"
+      },
       dataset_view_url: "https://www.dati.gov.it/view-dataset/dataset?id={id}",
       organization_view_url: "https://www.dati.gov.it/view-dataset?organization={name}"
     },
@@ -180,6 +184,17 @@ function getPortalHvdConfig(serverUrl) {
   const portal = getPortalConfig(serverUrl);
   return portal?.hvd ?? null;
 }
+function getSparqlConfig(endpointUrl) {
+  const cleanUrl = normalizeUrl(endpointUrl);
+  const portal = portals_default.portals.find(
+    (p) => p.sparql && normalizeUrl(p.sparql.endpoint_url) === cleanUrl
+  );
+  return portal?.sparql ?? null;
+}
+function getPortalSparqlConfig(serverUrl) {
+  const portal = getPortalConfig(serverUrl);
+  return portal?.sparql ?? null;
+}
 function getPortalApiPath(serverUrl) {
   const portal = getPortalConfig(serverUrl);
   return portal?.api_path || "/api/3/action";
@@ -857,7 +872,7 @@ function resolvePageParams(page, pageSize, start, rows) {
   }
   return { effectiveStart: start, effectiveRows: rows };
 }
-function compactSearchResult(result) {
+function compactSearchResult(result, serverUrl) {
   return {
     count: result.count,
     results: (result.results || []).map((pkg) => ({
@@ -868,13 +883,14 @@ function compactSearchResult(result) {
       organization: pkg.organization?.title || pkg.organization?.name || null,
       tags: (pkg.tags || []).map((t) => t.name),
       num_resources: pkg.num_resources ?? 0,
-      metadata_modified: pkg.metadata_modified
+      metadata_modified: pkg.metadata_modified,
+      ...serverUrl ? { view_url: getDatasetViewUrl(serverUrl, pkg) } : {}
     })),
     ...result.facets && Object.keys(result.facets).length > 0 ? { facets: result.facets } : {},
     ...result.search_facets && Object.keys(result.search_facets).length > 0 ? { search_facets: result.search_facets } : {}
   };
 }
-function compactPackageShow(result) {
+function compactPackageShow(result, serverUrl) {
   return {
     id: result.id,
     name: result.name,
@@ -902,7 +918,8 @@ function compactPackageShow(result) {
       datastore_active: r.datastore_active ?? null,
       created: r.created || null,
       last_modified: r.last_modified || null
-    }))
+    })),
+    ...serverUrl ? { view_url: getDatasetViewUrl(serverUrl, result) } : {}
   };
 }
 function registerPackageTools(server2) {
@@ -1096,7 +1113,7 @@ Typical workflow: ckan_package_search \u2192 ckan_package_show (get full metadat
           }
         }
         if (params.response_format === "json" /* JSON */) {
-          const compact = compactSearchResult(result);
+          const compact = compactSearchResult(result, params.server_url);
           return {
             content: [{ type: "text", text: truncateJson(compact) }]
           };
@@ -1481,7 +1498,7 @@ Typical workflow: ckan_package_show \u2192 pick a resource with datastore_active
           }
         );
         if (params.response_format === "json" /* JSON */) {
-          const compact = compactPackageShow(enrichPackageShowResult(result));
+          const compact = compactPackageShow(enrichPackageShowResult(result), params.server_url);
           return {
             content: [{ type: "text", text: truncateJson(compact) }],
             structuredContent: compact
@@ -2375,6 +2392,9 @@ Typical workflow: ckan_package_show (get resource_id) \u2192 ckan_datastore_sear
 // src/tools/status.ts
 import { z as z5 } from "zod";
 function formatStatusMarkdown(result, serverUrl) {
+  const sparql = getPortalSparqlConfig(serverUrl);
+  const sparqlLine = sparql ? `**SPARQL Endpoint**: ${sparql.endpoint_url}
+` : "";
   return `# CKAN Server Status
 
 **Server**: ${serverUrl}
@@ -2382,7 +2402,7 @@ function formatStatusMarkdown(result, serverUrl) {
 **CKAN Version**: ${result.ckan_version || "Unknown"}
 **Site Title**: ${result.site_title || "N/A"}
 **Site URL**: ${result.site_url || "N/A"}
-`;
+` + sparqlLine;
 }
 function registerStatusTools(server2) {
   server2.registerTool(
@@ -4004,19 +4024,41 @@ async function querySparqlEndpoint(endpointUrl, query) {
   if (url.protocol !== "https:") {
     throw new Error("Only HTTPS endpoints are allowed");
   }
+  const sparqlConfig = getSparqlConfig(endpointUrl);
+  const method = sparqlConfig?.method ?? "POST";
+  const commonHeaders = {
+    "Accept": "application/sparql-results+json",
+    "User-Agent": "Mozilla/5.0 (compatible; CKAN-MCP-Server/1.0)"
+  };
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), 15e3);
   let response;
   try {
-    response = await fetch(endpointUrl, {
-      method: "POST",
-      signal: controller.signal,
-      headers: {
-        "Content-Type": "application/sparql-query",
-        "Accept": "application/sparql-results+json"
-      },
-      body: query
-    });
+    if (method === "GET") {
+      const getUrl = new URL(endpointUrl);
+      getUrl.searchParams.set("query", query);
+      response = await fetch(getUrl.toString(), {
+        method: "GET",
+        signal: controller.signal,
+        headers: commonHeaders
+      });
+    } else {
+      response = await fetch(endpointUrl, {
+        method: "POST",
+        signal: controller.signal,
+        headers: { ...commonHeaders, "Content-Type": "application/sparql-query" },
+        body: query
+      });
+      if (response.status === 403 || response.status === 405) {
+        const getUrl = new URL(endpointUrl);
+        getUrl.searchParams.set("query", query);
+        response = await fetch(getUrl.toString(), {
+          method: "GET",
+          signal: controller.signal,
+          headers: commonHeaders
+        });
+      }
+    }
   } finally {
     clearTimeout(timeoutId);
   }
@@ -4681,7 +4723,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.67"
+    version: "0.4.68"
   });
 }
 function registerAll(server2) {