@opendata.cat/mcp-server 0.0.8 → 0.0.10

package/README.md

@@ -18,16 +18,18 @@ Un projecte d'**[opendata.cat](https://opendata.cat)** — associacio sense anim
 
 ## Portals disponibles
 
-| Portal | Datasets | Queryables | APIs |
-|--------|----------|-----------|------|
-| [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | 1.058 | Socrata (SoQL) |
-| [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | 463 | CKAN datastore |
-| [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | 32 | REST + JSON:API (CIDO) |
-| [Consorci AOC](https://dadesobertes.seu-e.cat) | ~893 | ~893 | CKAN datastore |
+| Portal | Datasets | APIs |
+|--------|----------|------|
+| [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | Socrata (SoQL) |
+| [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | CKAN datastore |
+| [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | REST + JSON:API (CIDO) |
+| [Consorci AOC](https://dadesobertes.seu-e.cat) | ~893 | CKAN datastore |
+| [Ajuntament de Reus](https://opendata.reus.cat) | 119 | CKAN datastore |
+| [Ajuntament de Girona](https://www.girona.cat/opendata/) | 53 | CKAN datastore |
 
 El Consorci AOC inclou datasets de les **diputacions de Tarragona, Girona i Lleida**, ajuntaments, consells comarcals i altres organismes publics catalans.
 
-**~2.400 datasets queryables** amb filtres, cerca i paginacio. La resta ofereix descarrega directa de fitxers.
+**+2.700 datasets** de 6 portals. La majoria queryables amb filtres, cerca i paginacio.
 
 El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per assegurar que funciona.
 

package/dist/clients/opendatasoft.d.ts

@@ -0,0 +1,4 @@
+export declare function queryOpendatasoft(endpoint: string, filters?: Record<string, string>, search?: string, limit?: number, offset?: number): Promise<{
+    records: Record<string, unknown>[];
+    total: number;
+}>;

package/dist/clients/opendatasoft.js

@@ -0,0 +1,20 @@
+export async function queryOpendatasoft(endpoint, filters, search, limit = 20, offset = 0) {
+    const url = new URL(endpoint);
+    if (filters && Object.keys(filters).length > 0) {
+        for (const [key, value] of Object.entries(filters)) {
+            url.searchParams.set(`refine.${key}`, value);
+        }
+    }
+    if (search)
+        url.searchParams.set("q", search);
+    url.searchParams.set("rows", String(Math.min(limit, 100)));
+    url.searchParams.set("start", String(offset));
+    const resp = await fetch(url.toString());
+    if (!resp.ok)
+        throw new Error(`Opendatasoft error ${resp.status}: ${resp.statusText}`);
+    const data = (await resp.json());
+    return {
+        records: data.records.map((r) => r.fields),
+        total: data.nhits,
+    };
+}

package/dist/clients/socrata.js

@@ -1,8 +1,12 @@
 export async function querySocrata(endpoint, filters, search, limit = 20, offset = 0) {
     const url = new URL(endpoint);
     if (filters && Object.keys(filters).length > 0) {
-        const clauses = Object.entries(filters).map(([key, value]) => `${key}='${value.replace(/'/g, "''")}'`);
-        url.searchParams.set("$where", clauses.join(" AND "));
+        const clauses = Object.entries(filters)
+            .filter(([key]) => /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(key))
+            .map(([key, value]) => `\`${key}\`='${value.replace(/'/g, "''")}'`);
+        if (clauses.length > 0) {
+            url.searchParams.set("$where", clauses.join(" AND "));
+        }
     }
     if (search)
         url.searchParams.set("$q", search);

package/dist/index.js

@@ -9,14 +9,15 @@ import { querySocrata } from "./clients/socrata.js";
 import { queryCkan } from "./clients/ckan.js";
 import { queryDiba } from "./clients/diba.js";
 import { queryCido } from "./clients/cido.js";
+import { queryOpendatasoft } from "./clients/opendatasoft.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.8",
+    version: "0.0.10",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
     query: z.string().describe("Text de cerca (ex: 'qualitat aire', 'pressupostos')"),
-    portal: z.string().optional().describe("Filtrar per portal: 'generalitat', 'barcelona' o 'diba'"),
+    portal: z.string().optional().describe("Filtrar per portal: 'generalitat', 'barcelona', 'diba', 'aoc', 'reus', 'girona', 'fgc'"),
     category: z.string().optional().describe("Filtrar per categoria"),
     limit: z.number().optional().default(20).describe("Nombre màxim de resultats (defecte: 20)"),
 }, async ({ query, portal, category, limit }) => {
@@ -89,6 +90,10 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
             const data = await queryCkan(dataset.api_endpoint, filters, search, limit, offset);
             results = data.records;
         }
+        else if (dataset.api_type === "opendatasoft") {
+            const data = await queryOpendatasoft(dataset.api_endpoint, filters, search, limit, offset);
+            results = data.records;
+        }
         else {
             return {
                 content: [{
@@ -116,21 +121,57 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
 // Tool 5: list_portals
 server.tool("list_portals", "Llista els portals de dades obertes catalans disponibles amb estadístiques.", {}, async () => {
     const portals = [
-        { id: "generalitat", name: "Generalitat de Catalunya", url: "https://analisi.transparenciacatalunya.cat", api_type: "socrata" },
-        { id: "barcelona", name: "Ajuntament de Barcelona", url: "https://opendata-ajuntament.barcelona.cat", api_type: "ckan" },
-        { id: "diba", name: "Diputació de Barcelona", url: "https://dadesobertes.diba.cat", api_type: "ckan" },
+        { id: "generalitat", name: "Generalitat de Catalunya", url: "https://analisi.transparenciacatalunya.cat", api: "Socrata" },
+        { id: "barcelona", name: "Ajuntament de Barcelona", url: "https://opendata-ajuntament.barcelona.cat", api: "CKAN" },
+        { id: "diba", name: "Diputació de Barcelona", url: "https://dadesobertes.diba.cat", api: "CKAN" },
+        { id: "aoc", name: "Consorci AOC (diputacions, ajuntaments, consells comarcals)", url: "https://dadesobertes.seu-e.cat", api: "CKAN" },
+        { id: "reus", name: "Ajuntament de Reus", url: "https://opendata.reus.cat", api: "CKAN" },
+        { id: "girona", name: "Ajuntament de Girona", url: "https://www.girona.cat/opendata/", api: "CKAN" },
+        { id: "fgc", name: "Ferrocarrils de la Generalitat de Catalunya", url: "https://dadesobertes.fgc.cat", api: "Opendatasoft" },
     ];
-    const counts = await Promise.all(portals.map(async (p) => {
-        const result = await searchDatasets("", p.id, undefined, 1);
-        return { ...p, dataset_count: result.total };
+    const cats = await getCategories();
+    const portalCounts = new Map(cats.portals.map((p) => [p.portal_id, p.total]));
+    const result = portals.map((p) => ({
+        ...p,
+        dataset_count: portalCounts.get(p.id) ?? 0,
     }));
-    return { content: [{ type: "text", text: JSON.stringify(counts, null, 2) }] };
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 });
 // Tool 6: list_categories
 server.tool("list_categories", "Llista totes les categories i temes de datasets disponibles amb comptadors per portal. Útil per saber quins tipus de dades hi ha.", {}, async () => {
     const cats = await getCategories();
     return { content: [{ type: "text", text: JSON.stringify(cats, null, 2) }] };
 });
+// Tool 7: related_datasets
+server.tool("related_datasets", "Retorna datasets relacionats d'ALTRES portals. Ideal per descobrir dades complementàries.", {
+    dataset_id: z.string().describe("ID del dataset del qual vols trobar relacionats"),
+}, async ({ dataset_id }) => {
+    const dataset = await getDatasetInfo(dataset_id);
+    if (!dataset) {
+        return { content: [{ type: "text", text: `Dataset '${dataset_id}' no trobat.` }] };
+    }
+    // Fetch related from API (stored in DB by enrichment script)
+    const resp = await fetch(`https://opendata.cat/api/dataset.php?id=${encodeURIComponent(dataset_id)}`);
+    if (!resp.ok) {
+        return { content: [{ type: "text", text: "Error obtenint relacions." }] };
+    }
+    const full = await resp.json();
+    const related = full.related ?? [];
+    if (!related.length) {
+        return { content: [{ type: "text", text: `No hi ha datasets relacionats per a '${dataset.name}'.` }] };
+    }
+    // Enrich with names
+    const details = await Promise.all(related.slice(0, 5).map(async (r) => {
+        const info = await getDatasetInfo(r.id);
+        return info ? { dataset_id: r.id, name: info.name, portal: info.portal_id, category: info.category, similarity: r.score } : null;
+    }));
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({ dataset: dataset.name, related: details.filter(Boolean) }, null, 2),
+            }],
+    };
+});
 async function main() {
     const mode = process.argv.includes("--http") ? "http" : "stdio";
     const port = parseInt(process.env.MCP_PORT || "3100", 10);
@@ -149,7 +190,7 @@ async function main() {
             // Health check
             if (req.url === "/health") {
                 res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.8" }));
+                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.10" }));
                 return;
             }
             // MCP endpoint

package/package.json

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