@cyanheads/eurostat-mcp-server 0.2.0 → 0.4.0

package/dist/services/eurostat-data/types.d.ts

@@ -58,6 +58,20 @@ export interface Observation {
     };
     value: number | null;
 }
+/**
+ * One observation flattened into a dataframe row.
+ *
+ * A dataframe column holds a scalar, so `Observation`'s nested `{code, label}`
+ * pair per dimension is split across two columns — `<dim>` for the code and
+ * `<dim>_label` for the label — and the status flag likewise. The measure
+ * columns carry the `obs_` prefix Eurostat's own SDMX-CSV output uses, which
+ * also keeps them clear of any dimension code.
+ */
+export type ObservationRow = Record<string, string | number | null>;
+/** Measure column names — the non-dimension columns of an {@link ObservationRow}. */
+export declare const OBS_VALUE_COLUMN = "obs_value";
+export declare const OBS_FLAG_COLUMN = "obs_flag";
+export declare const OBS_FLAG_LABEL_COLUMN = "obs_flag_label";
 /**
  * Metadata about a dataset extracted from a JSON-stat response.
  *
@@ -76,16 +90,28 @@ export interface DatasetMeta {
         end?: string;
     };
 }
+/**
+ * One dimension of a dataset.
+ *
+ * `valuesCount`/`sampleValues` are absent when the dimension's value set could not be
+ * measured. That happens for `time`, whose real period range takes a second request the
+ * rest of the metadata does not depend on: when that request fails, the fields are omitted
+ * rather than filled from the one-period slice, which would report a period count of 1 for
+ * every dataset.
+ */
 export interface DimensionInfo {
     code: string;
     label: string;
-    /** First 10 values as orientation. */
-    sampleValues: Array<{
+    /** First 10 values as orientation. Absent when the value set was not measured. */
+    sampleValues?: Array<{
         code: string;
         label: string;
     }>;
-    /** Distinct values for this dimension: the dataset's full period set for `time`, the most recent period's codelist otherwise. */
-    valuesCount: number;
+    /**
+     * Distinct values for this dimension: the dataset's full period set for `time`, the most
+     * recent period's codelist otherwise. Absent when the value set was not measured.
+     */
+    valuesCount?: number;
 }
 export interface DimensionValuesResult {
     dimensionCode: string;
@@ -99,6 +125,11 @@ export interface DimensionValuesResult {
 /**
  * A decoded query result.
  *
+ * `observations` is capped at `OBS_CAP`; `obsCount`, `missingObsCount` and `timeRange`
+ * describe the whole match, so `obsCount` and `observations.length` diverge whenever the
+ * cap bites. They are counted from the response's cell keys rather than from the decoded
+ * array, so capping never changes what they report.
+ *
  * `timeRange` bounds are absent when neither the returned observations nor the dataset-wide
  * annotations report them — an unknown bound is not an empty period.
  */
@@ -108,14 +139,40 @@ export interface QueryResult {
     datasetCode: string;
     datasetLabel: string;
     dimensionsUsed: string[];
+    /** Observations with no value across the whole match, not just the decoded page. */
     missingObsCount: number;
+    /** Observations matched upstream, before the `OBS_CAP` decode cap. */
     obsCount: number;
+    /** Decoded observations, capped at `OBS_CAP` — the first cap rows in linear-index order. */
     observations: Observation[];
     timeRange: {
         start?: string;
         end?: string;
     };
 }
+/**
+ * A query result plus a lazy row source over everything it matched.
+ *
+ * `observations` stops at `OBS_CAP`; `rows()` does not. Both read the same
+ * single walk of the response, so the capped list is always a prefix of the row
+ * source rather than a separately-derived set that can drift from it.
+ */
+export interface QueryExecution extends QueryResult {
+    /**
+     * Fresh generator over every matched cell, in the same order `observations`
+     * uses. Nothing is materialized until a consumer pulls, so staging a
+     * million-cell match costs one row object at a time rather than an array of
+     * them — the allocation `OBS_CAP` exists to avoid.
+     */
+    rows: () => Generator<ObservationRow>;
+}
+/**
+ * Upper bound on decoded observations returned for one query.
+ *
+ * Applied inside the decoder, so an oversized match never materializes as observation
+ * objects. The totals alongside `observations` stay honest about the full match.
+ */
+export declare const OBS_CAP = 5000;
 export type GeoLevel = 'aggregate' | 'country' | 'nuts1' | 'nuts2' | 'nuts3';
 /** Tuple of valid GeoLevel values — use with `z.enum(GEO_LEVEL_VALUES)` in tool schemas. */
 export declare const GEO_LEVEL_VALUES: readonly ["aggregate", "country", "nuts1", "nuts2", "nuts3"];

package/dist/services/eurostat-data/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/eurostat-data/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/eurostat-data/types.ts"],"names":[],"mappings":"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"}

package/dist/services/eurostat-data/types.js

@@ -2,6 +2,17 @@
  * @fileoverview Domain types for the Eurostat Statistics API (JSON-stat 2.0) service.
  * @module services/eurostat-data/types
  */
+/** Measure column names — the non-dimension columns of an {@link ObservationRow}. */
+export const OBS_VALUE_COLUMN = 'obs_value';
+export const OBS_FLAG_COLUMN = 'obs_flag';
+export const OBS_FLAG_LABEL_COLUMN = 'obs_flag_label';
+/**
+ * Upper bound on decoded observations returned for one query.
+ *
+ * Applied inside the decoder, so an oversized match never materializes as observation
+ * objects. The totals alongside `observations` stay honest about the full match.
+ */
+export const OBS_CAP = 5_000;
 /** Tuple of valid GeoLevel values — use with `z.enum(GEO_LEVEL_VALUES)` in tool schemas. */
 export const GEO_LEVEL_VALUES = [
     'aggregate',

package/dist/services/eurostat-data/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/eurostat-data/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqGH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;CAC+B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/eurostat-data/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4DH,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAyFtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;AAI7B,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;CAC+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/eurostat-mcp-server",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "mcpName": "io.github.cyanheads/eurostat-mcp-server",
   "description": "Search and query the Eurostat catalogue — EU economy, demography, trade, health, and NUTS regional data via MCP. STDIO or Streamable HTTP.",
   "type": "module",
@@ -79,6 +79,7 @@
   },
   "dependencies": {
     "@cyanheads/mcp-ts-core": "^0.11.1",
+    "@duckdb/node-api": "^1.5.5-r.3",
     "pino-pretty": "^13.1.3",
     "zod": "^4.4.3"
   },

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cyanheads/eurostat-mcp-server",
-  "description": "Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.",
+  "description": "Search and query the Eurostat catalogue \u2014 EU economy, demography, trade, and NUTS regional data.",
   "repository": {
     "url": "https://github.com/cyanheads/eurostat-mcp-server",
     "source": "github"
@@ -12,14 +12,14 @@
       "url": "https://eurostat.caseyjhand.com/mcp"
     }
   ],
-  "version": "0.2.0",
+  "version": "0.4.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/eurostat-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.2.0",
+      "version": "0.4.0",
       "packageArguments": [
         {
           "type": "positional",
@@ -58,6 +58,33 @@
           "format": "string",
           "isRequired": false,
           "default": "43200000"
+        },
+        {
+          "name": "CANVAS_PROVIDER_TYPE",
+          "description": "Set to 'duckdb' to enable the dataframe canvas, which lists the eurostat_dataframe_describe and eurostat_dataframe_query tools and lets eurostat_query_dataset stage a match larger than its 5,000-row inline cap as a SQL table. The DuckDB binding ships with the server, so this variable is the only switch.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "CANVAS_TEMP_PATH",
+          "description": "Directory DuckDB writes canvas spill files to. Must be writable by the server process. Defaults to a 'mcp-canvas' directory under the OS temp directory.",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "CANVAS_TTL_MS",
+          "description": "Sliding lifetime of a staged dataframe canvas in milliseconds; every call against it extends the window. Defaults to 24 hours.",
+          "format": "string",
+          "isRequired": false,
+          "default": "86400000"
+        },
+        {
+          "name": "CANVAS_DEFAULT_ROW_LIMIT",
+          "description": "Maximum rows a single eurostat_dataframe_query returns before the result is reported as truncated.",
+          "format": "string",
+          "isRequired": false,
+          "default": "10000"
         }
       ],
       "transport": {
@@ -69,7 +96,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/eurostat-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.2.0",
+      "version": "0.4.0",
       "packageArguments": [
         {
           "type": "positional",
@@ -142,6 +169,33 @@
           "format": "string",
           "isRequired": false,
           "default": "43200000"
+        },
+        {
+          "name": "CANVAS_PROVIDER_TYPE",
+          "description": "Set to 'duckdb' to enable the dataframe canvas, which lists the eurostat_dataframe_describe and eurostat_dataframe_query tools and lets eurostat_query_dataset stage a match larger than its 5,000-row inline cap as a SQL table. The DuckDB binding ships with the server, so this variable is the only switch.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "CANVAS_TEMP_PATH",
+          "description": "Directory DuckDB writes canvas spill files to. Must be writable by the server process. Defaults to a 'mcp-canvas' directory under the OS temp directory.",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "CANVAS_TTL_MS",
+          "description": "Sliding lifetime of a staged dataframe canvas in milliseconds; every call against it extends the window. Defaults to 24 hours.",
+          "format": "string",
+          "isRequired": false,
+          "default": "86400000"
+        },
+        {
+          "name": "CANVAS_DEFAULT_ROW_LIMIT",
+          "description": "Maximum rows a single eurostat_dataframe_query returns before the result is reported as truncated.",
+          "format": "string",
+          "isRequired": false,
+          "default": "10000"
         }
       ],
       "transport": {