@opendata.cat/mcp-server 0.0.3 → 0.0.5

package/README.md

@@ -17,13 +17,18 @@ Un projecte d'**[opendata.cat](https://opendata.cat)** — associacio sense anim
 
 ## Portals disponibles
 
-| Portal | Datasets | API | Dades |
-|--------|----------|-----|-------|
-| [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | Socrata | Medi ambient, salut, educacio, economia, transport... |
-| [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | CKAN | Urbanisme, mobilitat, cultura, demografia, pressupostos... |
-| [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | CKAN | Municipis, equipaments, patrimoni, energia, territori... |
-
-El cataleg s'actualitza automaticament cada setmana.
+| Portal | Datasets | Queryables | API | Dades |
+|--------|----------|-----------|-----|-------|
+| [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | 1.058 | Socrata | Medi ambient, salut, educacio, economia, transport... |
+| [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | ~464 | CKAN | Urbanisme, mobilitat, cultura, demografia, pressupostos... |
+| [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | ~29 | REST | Municipis, equipaments, patrimoni, energia, territori... |
+
+El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per assegurar que funciona.
+
+**Tipus d'acces:**
+- **Queryable** (socrata, ckan, diba): consulta amb filtres, cerca i paginacio directa
+- **File download**: descarrega directa de CSV, JSON, XLSX o fitxers GIS
+- **Restricted**: requereix token d'autenticacio
 
 ## Installacio rapida
 

package/dist/api.d.ts

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

package/dist/index.js

@@ -8,7 +8,7 @@ import { queryCkan } from "./clients/ckan.js";
 import { queryDiba } from "./clients/diba.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.3",
+    version: "0.0.5",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -57,6 +57,18 @@ 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") {
@@ -66,10 +78,18 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
             const data = await queryDiba(dataset.api_endpoint, filters, search, limit, offset);
             results = data.elements;
         }
-        else {
+        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.3",
+  "version": "0.0.5",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",