@opendata.cat/mcp-server 0.0.9 → 0.0.10

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.9",
+    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,15 +121,21 @@ 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 () => {
@@ -179,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.9" }));
+                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.9",
+  "version": "0.0.10",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",