@opendata.cat/mcp-server 0.0.4 → 0.0.6

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/clients/cido.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Consulta l'API JSON:API CIDO de la Diputació de Barcelona (api.diba.cat).
+ *
+ * Endpoints: contractacions, convenis, normatives-locals, oposicions, subvencions
+ *
+ * Filtres: filter[camp]=valor (camps d'atributs directes, NO relacions)
+ *   Ex: filter[institucioDesenvolupat]=Ajuntament de Tiana
+ *   Ex: filter[any]=2024
+ *   Ex: filter[estat]=En termini
+ *
+ * Ordenació: sort=-maxDataPublicacioDocument (descendent)
+ */
+export declare function queryCido(endpoint: string, filters?: Record<string, string>, search?: string, limit?: number, offset?: number): Promise<{
+    data: Record<string, unknown>[];
+    total: number;
+}>;

package/dist/clients/cido.js

@@ -0,0 +1,34 @@
+/**
+ * Consulta l'API JSON:API CIDO de la Diputació de Barcelona (api.diba.cat).
+ *
+ * Endpoints: contractacions, convenis, normatives-locals, oposicions, subvencions
+ *
+ * Filtres: filter[camp]=valor (camps d'atributs directes, NO relacions)
+ *   Ex: filter[institucioDesenvolupat]=Ajuntament de Tiana
+ *   Ex: filter[any]=2024
+ *   Ex: filter[estat]=En termini
+ *
+ * Ordenació: sort=-maxDataPublicacioDocument (descendent)
+ */
+export async function queryCido(endpoint, filters, search, limit = 20, offset = 0) {
+    const url = new URL(endpoint);
+    if (filters) {
+        for (const [key, value] of Object.entries(filters)) {
+            url.searchParams.set(`filter[${key}]`, value);
+        }
+    }
+    // CIDO no té cerca de text lliure, però podem filtrar per títol
+    if (search) {
+        url.searchParams.set("filter[titol]", search);
+    }
+    url.searchParams.set("sort", "-maxDataPublicacioDocument");
+    const resp = await fetch(url.toString());
+    if (!resp.ok) {
+        const err = await resp.json().catch(() => ({}));
+        const detail = err.errors?.[0]?.detail ?? resp.statusText;
+        throw new Error(`CIDO error ${resp.status}: ${detail}`);
+    }
+    const result = await resp.json();
+    const data = (result.data ?? []).slice(offset, offset + limit).map((item) => item.attributes ?? {});
+    return { data, total: result.data?.length ?? 0 };
+}

package/dist/index.js

@@ -6,9 +6,10 @@ 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";
+import { queryCido } from "./clients/cido.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.4",
+    version: "0.0.6",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -78,6 +79,10 @@ 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 if (dataset.api_type === "diba_cido") {
+            const data = await queryCido(dataset.api_endpoint, filters, search, limit, offset);
+            results = data.data;
+        }
         else if (dataset.api_type === "ckan") {
             const data = await queryCkan(dataset.api_endpoint, filters, search, limit, offset);
             results = data.records;

package/package.json

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