@opendata.cat/mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -142,45 +142,18 @@ Llista els portals disponibles amb el nombre de datasets de cadascun. No requere
 
 Llista totes les categories i temes de datasets disponibles amb comptadors per portal. Ideal per descobrir quins tipus de dades hi ha.
 
-## Prompts disponibles
-
-Prompts predefinits que guien l'LLM pas a pas per fer analisis completes:
-
-| Prompt | Descripcio | Arguments |
-|--------|-----------|-----------|
-| `estat_embassaments` | Estat actual dels embassaments amb grafiques d'evolucio | — |
-| `trens_fgc_temps_real` | Retards, alertes i posicions dels trens FGC en temps real | — |
-| `qualitat_aire` | Analisi de la qualitat de l'aire amb comparativa OMS/UE | `lloc` (opcional) |
-| `accidents_transit` | Analisi d'accidents de transit amb punts negres i tendencies | `municipi` (opcional) |
-| `pressupostos_municipals` | Pressupostos municipals amb desglossament per partides | `municipi` (opcional) |
-| `compara_municipis` | Compara dos municipis en totes les dades disponibles | `municipi_a`, `municipi_b` |
-| `descobreix_dades` | Mapa complet de dades obertes sobre un tema | `tema` |
-| `analisi_bombers` | Actuacions dels Bombers: emergencies, distribucio, tendencies | `comarca` (opcional) |
-| `novetats` | Datasets actualitzats mes recentment | `portal` (opcional) |
-| `datasets_populars` | Datasets mes consultats pels usuaris | — |
-| `explorar_portal` | Guia completa d'un portal: categories, exemples, destacats | `portal` |
-| `dades_municipi` | Fitxa completa d'un municipi amb totes les dades disponibles | `municipi` |
-| `datasets_temps_real` | Datasets amb dades en temps real o actualitzacio frequent | — |
-| `resum_portals` | Visio panoramica de tots els portals de dades obertes | — |
-
 ## Exemples d'us
 
 Un cop configurat, pots fer preguntes al teu LLM com:
 
-- *"Quin es l'estat dels embassaments de Catalunya?"* → prompt `estat_embassaments`
-- *"Hi ha algun tren de FGC amb retard ara mateix?"* → prompt `trens_fgc_temps_real`
-- *"Analitza la qualitat de l'aire a Terrassa"* → prompt `qualitat_aire`
-- *"Fes unes grafiques amb l'evolucio dels accidents de transit a Barcelona"* → prompt `accidents_transit`
-- *"Compara Girona i Tarragona en dades obertes"* → prompt `compara_municipis`
-- *"Quines dades obertes hi ha sobre educacio a Catalunya?"* → prompt `descobreix_dades`
-- *"Dona'm les ultimes dades de pressupostos de Reus"* → prompt `pressupostos_municipals`
-- *"Analitza les actuacions dels Bombers al Valles"* → prompt `analisi_bombers`
-- *"Quines novetats hi ha en dades obertes?"* → prompt `novetats`
-- *"Quins son els datasets mes consultats?"* → prompt `datasets_populars`
-- *"Explora'm el portal de la Generalitat"* → prompt `explorar_portal`
-- *"Quines dades obertes te Sabadell?"* → prompt `dades_municipi`
-- *"Quines dades en temps real hi ha?"* → prompt `datasets_temps_real`
-- *"Dona'm un resum de tots els portals"* → prompt `resum_portals`
+- *"Quin es l'estat dels embassaments de Catalunya?"*
+- *"Hi ha algun tren de FGC amb retard ara mateix?"*
+- *"Quina es la poblacio de Catalunya? I l'atur?"*
+- *"Analitza la qualitat de l'aire a Terrassa"*
+- *"Compara Girona i Tarragona en dades obertes"*
+- *"Quines dades obertes hi ha sobre educacio a Catalunya?"*
+- *"Dona'm les ultimes dades de pressupostos de Reus"*
+- *"Tenim informacio d'actuacions de bombers o del 112?"*
 
 ## Com funciona
 

package/dist/clients/idescat.js

@@ -3,14 +3,23 @@
  * Consulta indicadors estadístics de Catalunya amb sèries temporals.
  */
 export async function queryIdescat(endpoint) {
-    const resp = await fetch(endpoint);
+    // Extract indicator ID from endpoint (n=XXXXX or n=mXXXXX)
+    const idMatch = endpoint.match(/[?&]n=m?(\d+)/);
+    const targetId = idMatch ? `m${idMatch[1]}` : null;
+    // Fetch ALL indicators (max=200) and filter client-side
+    const allUrl = endpoint.replace(/&?n=m?\d+/, "").replace(/&?max=\d+/, "") + "&max=200";
+    const resp = await fetch(allUrl);
     if (!resp.ok)
         throw new Error(`Idescat error ${resp.status}: ${resp.statusText}`);
     const data = (await resp.json());
     const raw = data?.indicadors?.i;
     if (!raw)
         return { indicators: [], count: 0 };
-    const items = Array.isArray(raw) ? raw : [raw];
+    let items = Array.isArray(raw) ? raw : [raw];
+    // Filter by target indicator if specified
+    if (targetId) {
+        items = items.filter((item) => item.id === targetId);
+    }
     const indicators = items
         .filter((item) => item.id)
         .map((item) => {

package/dist/index.js

@@ -12,22 +12,59 @@ import { queryCido } from "./clients/cido.js";
 import { queryOpendatasoft } from "./clients/opendatasoft.js";
 import { decodeGtfsRt } from "./clients/gtfsrt.js";
 import { queryIdescat } from "./clients/idescat.js";
-const server = new McpServer({
-    name: "opendata-cat",
-    version: "0.1.0",
-});
+const INSTRUCTIONS = `Servidor MCP de dades obertes de Catalunya. Pots consultar dades reals directament amb query_dataset si coneixes el dataset_id.
+
+DATASETS DESTACATS (pots fer query_dataset directament sense cercar):
+- generalitat:gn9e-3qhr → Embassaments: camps dia, estaci, volum_embassat, percentatge_volum_embassat, nivell_absolut
+- generalitat:i5n8-43cw → Estat de sequera per municipi
+- generalitat:rmgc-ncpb → Accidents de trànsit amb morts o ferits greus
+- generalitat:jq8m-d7cw → Incidents operatius gestionats pel CAT 112
+- generalitat:mfqb-sbx4 → Trucades operatives gestionades pel CAT 112
+- generalitat:g2ay-3vnj → Actuacions dels Bombers de la Generalitat
+- generalitat:j6ii-t3w2 → Certificats d'eficiència energètica d'edificis
+- fgc:vehicle-positions-gtfs_realtime → Posició GPS dels trens FGC en temps real
+- fgc:alerts-gtfs_realtime → Alertes de servei FGC en temps real
+- fgc:trip-updates-gtfs_realtime → Retards dels trens FGC en temps real
+- idescat:m10328 → Població de Catalunya
+- idescat:m10234 → Confiança empresarial
+- barcelona:accidents-gu-bcn → Accidents gestionats per la Guàrdia Urbana BCN
+
+DADES MUNICIPALS (filtra per NOM_ENS amb query_dataset):
+- aoc:ge-ge-cost-efectiu-serveis-minhap → Cost dels serveis de +1.000 municipis
+- aoc:ge-p-pressupostos-i-plantilles → Pressupostos i plantilles municipals
+- aoc:ge-ge-endeutament → Endeutament municipal
+- aoc:ge-p-liquidacions-per-programes-detallat → Liquidació pressupostos per programes
+- aoc:ge-ge-termini-pagament-proveidors → Termini pagament a proveïdors
+
+PORTALS: generalitat (Socrata), barcelona (CKAN), diba (REST), aoc (CKAN), reus (CKAN), girona (CKAN), fgc (Opendatasoft+GTFS-RT), idescat (API indicadors)
+
+NOTES:
+- Socrata: pots filtrar per qualsevol camp. Ex: filters: {"estaci": "Embassament de Sau"}
+- CKAN AOC municipals: filtra per NOM_ENS (ex: "Ajuntament de Tiana"). Camps sovint en castellà.
+- Idescat: cada dataset_id retorna 1 indicador específic amb valor, unitat, període i sèrie temporal.
+- FGC GTFS-RT: decodificat automàticament. vehicle-positions dona GPS, alerts dona alertes en català.
+- Usa search_datasets només quan no saps quin dataset necessites.`;
+const server = new McpServer({ name: "opendata-cat", version: "0.1.2" }, { instructions: INSTRUCTIONS });
 // Tool 1: search_datasets
-server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. IMPORTANT: fes múltiples cerques amb termes diferents per cobrir un tema ampli. Ex: si l'usuari pregunta per 'emergències', cerca 'bombers', '112 trucades', 'mossos policia', 'SEM ambulància' per separat. La cerca inclou sinònims en català i castellà.", {
+server.tool("search_datasets", "Cerca datasets per text lliure. Mira primer les instructions del servidor: molts datasets es poden consultar directament amb query_dataset sense cercar. Usa search_datasets només quan no saps quin dataset necessites.", {
     query: z.string().describe("Text de cerca (ex: 'qualitat aire', 'pressupostos')"),
     portal: z.string().optional().describe("Filtrar per portal: 'generalitat', 'barcelona', 'diba', 'aoc', 'reus', 'girona', 'fgc', 'idescat'"),
     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 }) => {
     const result = await searchDatasets(query, portal, category, limit);
+    const queryableTypes = new Set(["socrata", "ckan", "opendatasoft", "idescat", "diba", "diba_cido"]);
+    const enriched = {
+        ...result,
+        items: result.items.map((item) => ({
+            ...item,
+            queryable: queryableTypes.has(item.api_type),
+        })),
+    };
     return {
         content: [{
                 type: "text",
-                text: JSON.stringify(result, null, 2),
+                text: JSON.stringify(enriched, null, 2),
             }],
     };
 });
@@ -52,8 +89,8 @@ server.tool("list_dataset_fields", "Llista els camps d'un dataset amb el seu nom
     return { content: [{ type: "text", text: JSON.stringify(dataset.fields, null, 2) }] };
 });
 // Tool 4: query_dataset
-server.tool("query_dataset", "Executa una consulta contra un dataset i retorna files de dades reals del portal origen.", {
-    dataset_id: z.string().describe("ID del dataset a consultar"),
+server.tool("query_dataset", "Consulta dades reals d'un dataset. Mira les instructions per dataset_ids destacats. Per dades municipals, usa filters: {\"NOM_ENS\": \"Ajuntament de X\"} amb els datasets aoc:ge-*.", {
+    dataset_id: z.string().describe("ID del dataset (ex: 'generalitat:gn9e-3qhr' per embassaments, 'aoc:ge-ge-cost-efectiu-serveis-minhap' per cost serveis municipal)"),
     filters: z.record(z.string(), z.string()).optional().describe("Filtres clau-valor (ex: {\"ciutat\": \"Barcelona\"})"),
     search: z.string().optional().describe("Cerca de text lliure dins el dataset"),
     limit: z.number().optional().default(20).describe("Files a retornar (defecte: 20, màxim: 100)"),
@@ -487,7 +524,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.1.0" }));
+                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.1.2" }));
                 return;
             }
             // MCP endpoint

package/package.json

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