@opendata.cat/mcp-server 0.0.2 → 0.0.4

package/dist/api.d.ts

@@ -14,7 +14,7 @@ export interface DatasetDetail {
     description: string;
     category: string;
     tags: string[];
-    api_type: "socrata" | "ckan";
+    api_type: string;
     api_endpoint: string;
     formats: string[];
     fields: {

package/dist/clients/diba.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Consulta l'API REST de la Diputació de Barcelona (do.diba.cat).
+ * Format: /api/dataset/{name}/format/json/pag-ini/{start}/pag-fi/{end}
+ * Filtres: /camp-filtre/{field}/valor-filtre/{value}
+ * Relacions: /camp-rel/{field}/valor-rel/{value}
+ */
+export declare function queryDiba(endpoint: string, filters?: Record<string, string>, search?: string, limit?: number, offset?: number): Promise<{
+    elements: Record<string, unknown>[];
+    total: number;
+}>;

package/dist/clients/diba.js

@@ -0,0 +1,29 @@
+/**
+ * Consulta l'API REST de la Diputació de Barcelona (do.diba.cat).
+ * Format: /api/dataset/{name}/format/json/pag-ini/{start}/pag-fi/{end}
+ * Filtres: /camp-filtre/{field}/valor-filtre/{value}
+ * Relacions: /camp-rel/{field}/valor-rel/{value}
+ */
+export async function queryDiba(endpoint, filters, search, limit = 20, offset = 0) {
+    let url = endpoint;
+    // Assegurar format JSON
+    if (!url.includes("/format/")) {
+        url += "/format/json";
+    }
+    // Paginació
+    url += `/pag-ini/${offset}/pag-fi/${offset + limit}`;
+    // Filtres
+    if (filters) {
+        for (const [key, value] of Object.entries(filters)) {
+            url += `/camp-filtre/${encodeURIComponent(key)}/valor-filtre/${encodeURIComponent(value)}`;
+        }
+    }
+    const resp = await fetch(url);
+    if (!resp.ok)
+        throw new Error(`Diba error ${resp.status}: ${resp.statusText}`);
+    const data = await resp.json();
+    return {
+        elements: data.elements ?? [],
+        total: data.entitats ?? 0,
+    };
+}

package/dist/index.js

@@ -5,9 +5,10 @@ import { z } from "zod";
 import { searchDatasets, getDatasetInfo, getCategories } from "./api.js";
 import { querySocrata } from "./clients/socrata.js";
 import { queryCkan } from "./clients/ckan.js";
+import { queryDiba } from "./clients/diba.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.2",
+    version: "0.0.4",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -56,15 +57,39 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
     if (!dataset) {
         return { content: [{ type: "text", text: `Dataset '${dataset_id}' no trobat.` }] };
     }
+    // Datasets no queryables: retornar enllaç directe
+    if (dataset.api_type === "file_download" || dataset.api_type === "restricted") {
+        const msg = dataset.api_type === "restricted"
+            ? `Aquest dataset requereix autenticació (token). Accedeix-hi directament:`
+            : `Aquest dataset no té API de consulta. Descarrega'l directament:`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `${msg}\n${dataset.api_endpoint}\n\nFormats disponibles: ${dataset.formats.join(", ")}`,
+                }],
+        };
+    }
     try {
         let results;
         if (dataset.api_type === "socrata") {
             results = await querySocrata(dataset.api_endpoint, filters, search, limit, offset);
         }
-        else {
+        else if (dataset.api_type === "diba") {
+            const data = await queryDiba(dataset.api_endpoint, filters, search, limit, offset);
+            results = data.elements;
+        }
+        else if (dataset.api_type === "ckan") {
             const data = await queryCkan(dataset.api_endpoint, filters, search, limit, offset);
             results = data.records;
         }
+        else {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Tipus d'API '${dataset.api_type}' no suportat per consulta directa.\nAccedeix al dataset: ${dataset.api_endpoint}`,
+                    }],
+            };
+        }
         return {
             content: [{
                     type: "text",

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",