@opendata.cat/mcp-server 0.0.12 → 0.0.13

package/README.md

@@ -193,6 +193,24 @@ Usuari → LLM → MCP opendata.cat → API opendata.cat (cataleg)
 
 No emmagatzema ni fa de proxy de dades. Cada consulta va directament a la font oficial.
 
+## API REST
+
+A mes del servidor MCP, opendata.cat ofereix una API REST publica per accedir al cataleg de datasets:
+
+| Endpoint | Descripcio |
+|----------|-----------|
+| `GET /api/datasets.php?q=...` | Cerca datasets per text lliure |
+| `GET /api/dataset.php?id=...` | Detall complet d'un dataset |
+| `GET /api/categories.php` | Categories i portals amb comptadors |
+| `GET /api/portals.php` | Portals de transparencia (1.769) |
+| `GET /api/stats.php` | Estadistiques agregades |
+| `GET /api/mcp-stats.php` | Metriques d'us del MCP |
+| `POST /api/mcp` | Servidor MCP (Streamable HTTP) |
+
+Documentacio interactiva (Swagger): **[opendata.cat/api/docs.html](https://opendata.cat/api/docs.html)**
+
+Especificacio OpenAPI: [`opendata.cat/api/openapi.json`](https://opendata.cat/api/openapi.json)
+
 ## Sobre opendata.cat
 
 [opendata.cat](https://opendata.cat) es una associacio catalana sense anim de lucre fundada el 2012 (registre 47468) dedicada a promoure la transparencia i l'acces a la informacio publica. Treballa en tres eixos: **estandarditzacio** de formats i protocols, **formacio** especialitzada per a professionals i administracions, i **collaboracio** publico-privada per a l'obertura de dades.

package/dist/index.js

@@ -92,6 +92,26 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
         }
         else if (dataset.api_type === "opendatasoft") {
             const data = await queryOpendatasoft(dataset.api_endpoint, filters, search, limit, offset);
+            // Detect GTFS-RT protobuf files
+            const first = data.records[0];
+            const fileField = first?.file;
+            if (fileField?.filename?.endsWith(".pb") || fileField?.filename?.endsWith(".pbf")) {
+                const dsMatch = dataset.api_endpoint.match(/dataset=([^&]+)/);
+                const baseMatch = dataset.api_endpoint.match(/(https?:\/\/[^/]+)/);
+                const infoUrl = baseMatch ? `${baseMatch[1]}/explore/dataset/${dsMatch?.[1] ?? ""}/information/` : dataset.api_endpoint;
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                dataset: dataset.name,
+                                format: "Protocol Buffers (GTFS-RT)",
+                                message: "Aquest dataset conté dades en format Protocol Buffers (.pb), un format binari per a transport públic en temps real (GTFS Realtime). No es pot llegir directament com a text/JSON. Per usar-lo cal un decoder GTFS-RT (ex: gtfs-realtime-bindings).",
+                                filename: fileField.filename,
+                                download_url: infoUrl,
+                            }, null, 2),
+                        }],
+                };
+            }
             results = data.records;
         }
         else {

package/package.json

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