@opendata.cat/mcp-server 0.0.7 → 0.0.9

package/README.md

@@ -4,6 +4,7 @@
 
 <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://www.npmjs.com/package/@opendata.cat/mcp-server"><img src="https://img.shields.io/npm/dm/@opendata.cat/mcp-server?color=c44536&label=downloads" alt="npm downloads"></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>
@@ -17,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/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
+import { createServer } from "node:http";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { z } from "zod";
 import { searchDatasets, getDatasetInfo, getCategories } from "./api.js";
 import { querySocrata } from "./clients/socrata.js";
@@ -9,7 +11,7 @@ import { queryDiba } from "./clients/diba.js";
 import { queryCido } from "./clients/cido.js";
 const server = new McpServer({
     name: "opendata-cat",
-    version: "0.0.7",
+    version: "0.0.9",
 });
 // Tool 1: search_datasets
 server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -129,8 +131,73 @@ server.tool("list_categories", "Llista totes les categories i temes de datasets
     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 transport = new StdioServerTransport();
-    await server.connect(transport);
+    const mode = process.argv.includes("--http") ? "http" : "stdio";
+    const port = parseInt(process.env.MCP_PORT || "3100", 10);
+    if (mode === "http") {
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+        const httpServer = createServer(async (req, res) => {
+            // CORS
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+            res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+            if (req.method === "OPTIONS") {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+            // 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" }));
+                return;
+            }
+            // MCP endpoint
+            if (req.url === "/mcp") {
+                await transport.handleRequest(req, res);
+                return;
+            }
+            res.writeHead(404);
+            res.end("Not found");
+        });
+        await server.connect(transport);
+        httpServer.listen(port, () => {
+            console.log(`MCP HTTP server running on port ${port}`);
+        });
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
 }
 main().catch(console.error);

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,7 @@
   ],
   "author": "opendata.cat",
   "license": "MIT",
+  "mcpName": "io.github.xaviviro/opendata-cat",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/xaviviro/Opendata.cat-MCP-Server.git"