@aborruso/ckan-mcp-server 0.4.126 → 0.4.127

package/LOG.md

@@ -1,5 +1,19 @@
 # LOG
 
+## 2026-09-24
+
+### v0.4.127
+
+Ships #554: `dct:temporal` coverage in `ckan_package_show` (markdown + JSON, every period, `start_equals_issued` flag) and `CKAN_ALLOWED_DOMAINS` declared optional in `server.json` for the MCP Registry. Smoke 17/17.
+
+### `ckan_package_show`: temporal coverage (dct:temporal)
+
+New `readTemporalCoverage()` reads `dct:temporal` in both shapes dati.gov.it uses: root `temporal_coverage` (JSON string, e.g. Comune di Coriano) and extras `temporal_start`/`temporal_end`/`temporal_coverage` (Regione Toscana, 12,426 datasets). Rendered as **Temporal Coverage (dct:temporal)** in markdown and `temporal_coverage: [{start, end, start_equals_issued}]` in JSON, every period kept; before, JSON had nothing and markdown only the extras case. `start_equals_issued` is a factual flag for start = issued with no end: a full scan of the 17,860 datasets with `temporal_start` found a third like that, and on the origin portals (dati.toscana.it, opendata.maggioli.cloud, opendata.uniba.it, all dcatapit) `temporal_coverage` is empty in the CKAN API while their RDF export emits `dct:temporal` with `startDate` = `dct:issued`. So it is an export artefact, not a publisher entry. INPS, MIT, LaMMA weather runs and Camera di Commercio Marche carry real spans.
+
+### server.json: declare `CKAN_ALLOWED_DOMAINS` as optional
+
+Claude Desktop's configure dialog asked for six env vars, `CKAN_ALLOWED_DOMAINS` marked required, inferred from the README HTTP table. The registry package is stdio, where the allowlist is optional. `server.json` now declares the one variable explicitly (`isRequired: false`, placeholder). Takes effect on the next registry publish.
+
 ## 2026-09-23
 
 ### v0.4.126 - why MQA URL tests fail

package/dist/index.js

@@ -1517,6 +1517,42 @@ var readDcatExtra = (dataset, key) => {
   const rootValue = dataset[key];
   return typeof rootValue === "string" ? rootValue : "";
 };
+var readExtra = (dataset, key) => {
+  const extras = Array.isArray(dataset.extras) ? dataset.extras : [];
+  for (const e of extras) {
+    if (e && typeof e === "object" && e.key === key) {
+      return e.value;
+    }
+  }
+  return void 0;
+};
+var toPeriod = (item) => {
+  if (!item || typeof item !== "object") return null;
+  const { temporal_start, temporal_end } = item;
+  const start = typeof temporal_start === "string" && temporal_start ? temporal_start : null;
+  const end = typeof temporal_end === "string" && temporal_end ? temporal_end : null;
+  return start || end ? { start, end } : null;
+};
+var parseTemporalCoverage = (raw) => {
+  let value = raw;
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return [];
+    }
+  }
+  const items = Array.isArray(value) ? value : [value];
+  return items.map(toPeriod).filter((p) => p !== null);
+};
+var readTemporalCoverage = (dataset) => {
+  const fromRoot = parseTemporalCoverage(dataset.temporal_coverage);
+  if (fromRoot.length > 0) return fromRoot;
+  const fromExtra = parseTemporalCoverage(readExtra(dataset, "temporal_coverage"));
+  if (fromExtra.length > 0) return fromExtra;
+  return parseTemporalCoverage({ temporal_start: readExtra(dataset, "temporal_start"), temporal_end: readExtra(dataset, "temporal_end") });
+};
+var startEqualsIssued = (period, issued) => period.end === null && typeof issued === "string" && period.start !== null && period.start.slice(0, 10) === issued.slice(0, 10);
 var scoreDatasetRelevance = (query, dataset, weights = DEFAULT_RELEVANCE_WEIGHTS, fullCoverage = false) => {
   const terms = extractQueryTerms(query);
   const titleText = dataset.title || dataset.name || "";
@@ -1655,6 +1691,15 @@ var formatPackageShowMarkdown = (result, serverUrl) => {
   const accessRights = dcatField("access_rights");
   if (accessRights) markdown += `- **Access Rights (dct:accessRights)**: ${sanitizeInline(accessRights)}
 `;
+  const periods = readTemporalCoverage(result);
+  if (periods.length > 0) {
+    const spans = periods.map((p) => {
+      const span = `${p.start ? formatDate(p.start) : "?"} \u2192 ${p.end ? formatDate(p.end) : "open"}`;
+      return startEqualsIssued(p, result.issued) ? `${span} (start equals issued, no end)` : span;
+    });
+    markdown += `- **Temporal Coverage (dct:temporal)**: ${sanitizeInline(spans.join("; "))}
+`;
+  }
   markdown += `
 `;
   if (result.organization) {
@@ -1888,6 +1933,7 @@ function compactPackageShow(result, serverUrl) {
     holder_name: result.holder_name || null,
     hvd_category: result.hvd_category || null,
     applicable_legislation: result.applicable_legislation || null,
+    temporal_coverage: readTemporalCoverage(result).map((p) => ({ ...p, start_equals_issued: startEqualsIssued(p, result.issued) })),
     resources: (result.resources || []).map((r) => ({
       id: r.id,
       name: r.name || null,
@@ -2500,6 +2546,8 @@ Returns (JSON format):
   author, maintainer,
   frequency, language, publisher_name, holder_name,
   hvd_category, applicable_legislation,
+  temporal_coverage (array of {start, end, start_equals_issued} from dct:temporal; empty if absent;
+    start_equals_issued=true when start = issued and no end: on dcatapit portals an export default, not a data period),
   resources (id, name, format, url, size, datastore_active, created, last_modified, api_json_url),
   view_url, api_json_url
 
@@ -5994,7 +6042,7 @@ var registerAllPrompts = (server) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.126"
+    version: "0.4.127"
   });
 }
 function registerAll(server) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aborruso/ckan-mcp-server",
-  "version": "0.4.126",
+  "version": "0.4.127",
   "mcpName": "io.github.aborruso/ckan-mcp-server",
   "description": "MCP server for interacting with CKAN open data portals",
   "repository": {