@opendata.cat/mcp-server 0.0.1 → 0.0.3

package/README.md

@@ -1,35 +1,42 @@
 <p align="center">
-  <img src="banner.png" alt="opendata.cat MCP — Connecta el teu LLM amb les dades obertes de Catalunya" width="100%">
+  <img src="banner.png" alt="Opendata.cat MCP Server — Connecta el teu LLM amb les dades obertes de Catalunya" width="100%">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@opendata.cat/mcp-server"><img src="https://img.shields.io/npm/v/@opendata.cat/mcp-server?color=c44536&label=npm" alt="npm"></a>
+  <a href="https://github.com/xaviviro/Opendata.cat-MCP-Server"><img src="https://img.shields.io/github/v/tag/xaviviro/Opendata.cat-MCP-Server?label=github&color=1a1a1a" alt="github"></a>
+  <a href="https://opendata.cat/mcp"><img src="https://img.shields.io/badge/web-opendata.cat%2Fmcp-c9a227" alt="web"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
 </p>
 
 # Opendata.cat MCP Server
 
-Servidor [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) que connecta els models de llenguatge (Claude, ChatGPT, Gemini...) amb les **dades obertes públiques de Catalunya**. Cerca datasets, explora metadades i consulta dades reals de la Generalitat, l'Ajuntament de Barcelona i la Diputació de Barcelona directament des del teu assistent d'IA.
+Servidor [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) que connecta els models de llenguatge (Claude, ChatGPT, Gemini...) amb les **dades obertes publiques de Catalunya**. Cerca datasets, explora metadades i consulta dades reals de la Generalitat, l'Ajuntament de Barcelona i la Diputacio de Barcelona directament des del teu assistent d'IA.
 
-Un projecte d'**[opendata.cat](https://opendata.cat)** — associació sense ànim de lucre fundada el 2012 que promou la transparència, la difusió i l'estandardització de les dades obertes a Catalunya. Organitza formacions, conferències i desenvolupa plataformes per facilitar l'accés a la informació pública.
+Un projecte d'**[opendata.cat](https://opendata.cat)** — associacio sense anim de lucre fundada el 2012 que promou la transparencia, la difusio i l'estandarditzacio de les dades obertes a Catalunya. Inspirat en el projecte [datagouv-mcp](https://github.com/datagouv/datagouv-mcp) del govern frances.
 
 ## Portals disponibles
 
 | Portal | Datasets | API | Dades |
 |--------|----------|-----|-------|
-| [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | ~1.480 | Socrata | Medi ambient, salut, educació, economia, transport... |
-| [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | ~1.036 | CKAN | Urbanisme, mobilitat, cultura, demografia, pressupostos... |
-| [Diputació de Barcelona](https://dadesobertes.diba.cat) | ~124 | CKAN | Municipis, equipaments, patrimoni, energia, territori... |
+| [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... |
 
-**+2.600 datasets** actualitzats automàticament cada setmana.
+El cataleg s'actualitza automaticament cada setmana.
 
-## Instal·lació ràpida
+## Installacio rapida
 
 ### Claude Desktop
 
-Afegeix al fitxer de configuració (`~/Library/Application Support/Claude/claude_desktop_config.json` a macOS o `%APPDATA%\Claude\claude_desktop_config.json` a Windows):
+Afegeix al fitxer de configuracio (`~/Library/Application Support/Claude/claude_desktop_config.json` a macOS o `%APPDATA%\Claude\claude_desktop_config.json` a Windows):
 
 ```json
 {
   "mcpServers": {
     "opendata-cat": {
       "command": "npx",
-      "args": ["-y", "opendata-cat-mcp-server"]
+      "args": ["-y", "@opendata.cat/mcp-server"]
     }
   }
 }
@@ -38,7 +45,7 @@ Afegeix al fitxer de configuració (`~/Library/Application Support/Claude/claude
 ### Claude Code (CLI)
 
 ```bash
-claude mcp add opendata-cat -- npx -y opendata-cat-mcp-server
+claude mcp add opendata-cat -- npx -y @opendata.cat/mcp-server
 ```
 
 ### VS Code / Cursor
@@ -50,7 +57,7 @@ Afegeix al fitxer `.vscode/mcp.json` del teu projecte:
   "servers": {
     "opendata-cat": {
       "command": "npx",
-      "args": ["-y", "opendata-cat-mcp-server"]
+      "args": ["-y", "@opendata.cat/mcp-server"]
     }
   }
 }
@@ -58,13 +65,13 @@ Afegeix al fitxer `.vscode/mcp.json` del teu projecte:
 
 ## Tools disponibles
 
-| Tool | Descripció |
+| Tool | Descripcio |
 |------|-----------|
-| `search_datasets` | Cerca datasets per text lliure al catàleg de +2.600 datasets |
-| `get_dataset_info` | Retorna metadades completes: camps, tipus, llicència, endpoint |
-| `list_dataset_fields` | Llista els camps d'un dataset amb nom, tipus i descripció |
+| `search_datasets` | Cerca datasets per text lliure al cataleg |
+| `get_dataset_info` | Retorna metadades completes: camps, tipus, llicencia, endpoint |
+| `list_dataset_fields` | Llista els camps d'un dataset amb nom, tipus i descripcio |
 | `query_dataset` | Consulta dades reals directament al portal origen |
-| `list_portals` | Llista els portals disponibles amb estadístiques |
+| `list_portals` | Llista els portals disponibles amb estadistiques |
 | `list_categories` | Llista categories i temes disponibles amb comptadors |
 
 ### search_datasets
@@ -88,7 +95,7 @@ dataset_id: "generalitat:gn9e-3qhr"
 
 ### list_dataset_fields
 
-Llista els camps d'un dataset amb nom, tipus i descripció.
+Llista els camps d'un dataset amb nom, tipus i descripcio.
 
 ```
 dataset_id: "generalitat:gn9e-3qhr"
@@ -102,34 +109,34 @@ Executa una consulta directament contra el portal origen i retorna dades reals.
 dataset_id: "generalitat:gn9e-3qhr"
 filters: {"estaci": "Sau"}   # opcional
 search: "embassament"         # opcional
-limit: 20                     # opcional (defecte: 20, màx: 100)
+limit: 20                     # opcional (defecte: 20, max: 100)
 offset: 0                     # opcional
 ```
 
 ### list_portals
 
-Llista els portals disponibles amb el nombre de datasets de cadascun. No requereix paràmetres.
+Llista els portals disponibles amb el nombre de datasets de cadascun. No requereix parametres.
 
 ### list_categories
 
 Llista totes les categories i temes de datasets disponibles amb comptadors per portal. Ideal per descobrir quins tipus de dades hi ha.
 
-## Exemples d'ús
+## Exemples d'us
 
 Un cop configurat, pots fer preguntes al teu LLM com:
 
 - *"Quins datasets hi ha sobre mobilitat a Barcelona?"*
 - *"Mostra'm les dades de qualitat de l'aire d'ahir"*
-- *"Quants equipaments culturals té Girona?"*
-- *"Dona'm les últimes dades de pressupostos municipals"*
-- *"Quin és l'estat dels embassaments de Catalunya?"*
-- *"Compara les dades de transport públic entre Barcelona i la Diputació"*
-- *"Quines dades obertes hi ha sobre educació a Catalunya?"*
+- *"Quants equipaments culturals te Girona?"*
+- *"Dona'm les ultimes dades de pressupostos municipals"*
+- *"Quin es l'estat dels embassaments de Catalunya?"*
+- *"Quines dades obertes hi ha sobre educacio a Catalunya?"*
+- *"Quins tipus de dades teniu disponibles?"*
 
 ## Com funciona
 
 ```
-Usuari → LLM → MCP opendata.cat → API opendata.cat (catàleg)
+Usuari → LLM → MCP opendata.cat → API opendata.cat (cataleg)
                                  → Portal origen (dades reals)
 ```
 
@@ -141,15 +148,15 @@ No emmagatzema ni fa de proxy de dades. Cada consulta va directament a la font o
 
 ## Sobre opendata.cat
 
-[opendata.cat](https://opendata.cat) és una associació catalana sense ànim de lucre fundada el 2012 (registre 47468) dedicada a promoure la transparència i l'accés a la informació pública. Treballa en tres eixos: **estandardització** de formats i protocols, **formació** especialitzada per a professionals i administracions, i **col·laboració** público-privada per a l'obertura de dades.
+[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.
 
 ## Contribuir
 
-Les contribucions són benvingudes! Per afegir un nou portal de dades obertes:
+Les contribucions son benvingudes! Per afegir un nou portal de dades obertes:
 
 1. Obre una [issue](https://github.com/xaviviro/Opendata.cat-MCP-Server/issues) amb la URL del portal i el tipus d'API
 2. O envia un pull request
 
-## Llicència
+## Llicencia
 
 MIT

package/dist/api.d.ts

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

package/dist/clients/diba.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Consulta l'API REST de la Diputació de Barcelona (do.diba.cat).
+ * Format: /api/dataset/{name}/format/json/pag-ini/{start}/pag-fi/{end}
+ * Filtres: /camp-filtre/{field}/valor-filtre/{value}
+ * Relacions: /camp-rel/{field}/valor-rel/{value}
+ */
+export declare function queryDiba(endpoint: string, filters?: Record<string, string>, search?: string, limit?: number, offset?: number): Promise<{
+    elements: Record<string, unknown>[];
+    total: number;
+}>;

package/dist/clients/diba.js

@@ -0,0 +1,29 @@
+/**
+ * Consulta l'API REST de la Diputació de Barcelona (do.diba.cat).
+ * Format: /api/dataset/{name}/format/json/pag-ini/{start}/pag-fi/{end}
+ * Filtres: /camp-filtre/{field}/valor-filtre/{value}
+ * Relacions: /camp-rel/{field}/valor-rel/{value}
+ */
+export async function queryDiba(endpoint, filters, search, limit = 20, offset = 0) {
+    let url = endpoint;
+    // Assegurar format JSON
+    if (!url.includes("/format/")) {
+        url += "/format/json";
+    }
+    // Paginació
+    url += `/pag-ini/${offset}/pag-fi/${offset + limit}`;
+    // Filtres
+    if (filters) {
+        for (const [key, value] of Object.entries(filters)) {
+            url += `/camp-filtre/${encodeURIComponent(key)}/valor-filtre/${encodeURIComponent(value)}`;
+        }
+    }
+    const resp = await fetch(url);
+    if (!resp.ok)
+        throw new Error(`Diba error ${resp.status}: ${resp.statusText}`);
+    const data = await resp.json();
+    return {
+        elements: data.elements ?? [],
+        total: data.entitats ?? 0,
+    };
+}

package/dist/index.js

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