@opendata.cat/mcp-server 0.0.6 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +48 -7
  2. package/dist/index.js +40 -3
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -4,6 +4,7 @@
4
4
 
5
5
  <p align="center">
6
6
  <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>
7
+ <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>
7
8
  <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>
8
9
  <a href="https://opendata.cat/mcp"><img src="https://img.shields.io/badge/web-opendata.cat%2Fmcp-c9a227" alt="web"></a>
9
10
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
@@ -17,18 +18,26 @@ Un projecte d'**[opendata.cat](https://opendata.cat)** — associacio sense anim
17
18
 
18
19
  ## Portals disponibles
19
20
 
20
- | Portal | Datasets | Queryables | API | Dades |
21
- |--------|----------|-----------|-----|-------|
22
- | [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | 1.058 | Socrata | Medi ambient, salut, educacio, economia, transport... |
23
- | [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | ~464 | CKAN | Urbanisme, mobilitat, cultura, demografia, pressupostos... |
24
- | [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | ~29 | REST | Municipis, equipaments, patrimoni, energia, territori... |
21
+ | Portal | Datasets | Queryables | APIs |
22
+ |--------|----------|-----------|------|
23
+ | [Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat) | 1.058 | 1.058 | Socrata (SoQL) |
24
+ | [Ajuntament de Barcelona](https://opendata-ajuntament.barcelona.cat) | 555 | 463 | CKAN datastore |
25
+ | [Diputacio de Barcelona](https://dadesobertes.diba.cat) | 90 | 32 | REST + JSON:API (CIDO) |
26
+ | [Consorci AOC](https://dadesobertes.seu-e.cat) | ~893 | ~893 | CKAN datastore |
27
+
28
+ El Consorci AOC inclou datasets de les **diputacions de Tarragona, Girona i Lleida**, ajuntaments, consells comarcals i altres organismes publics catalans.
29
+
30
+ **~2.400 datasets queryables** amb filtres, cerca i paginacio. La resta ofereix descarrega directa de fitxers.
25
31
 
26
32
  El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per assegurar que funciona.
27
33
 
28
34
  **Tipus d'acces:**
29
- - **Queryable** (socrata, ckan, diba): consulta amb filtres, cerca i paginacio directa
35
+ - **Socrata**: consulta SoQL amb filtres i cerca (Generalitat)
36
+ - **CKAN**: datastore_search amb filtres i cerca (Barcelona, AOC)
37
+ - **Diba REST**: API do.diba.cat amb paginacio i filtres (Diputacio BCN)
38
+ - **CIDO JSON:API**: api.diba.cat per contractacions, normatives, subvencions, oposicions, convenis (Diputacio BCN)
30
39
  - **File download**: descarrega directa de CSV, JSON, XLSX o fitxers GIS
31
- - **Restricted**: requereix token d'autenticacio
40
+ - **Restricted**: requereix token d'autenticacio (4 datasets BSM)
32
41
 
33
42
  ## Installacio rapida
34
43
 
@@ -162,6 +171,38 @@ Les contribucions son benvingudes! Per afegir un nou portal de dades obertes:
162
171
  1. Obre una [issue](https://github.com/xaviviro/Opendata.cat-MCP-Server/issues) amb la URL del portal i el tipus d'API
163
172
  2. O envia un pull request
164
173
 
174
+ ## Changelog
175
+
176
+ ### v0.0.7 (2026-04-13)
177
+ - Afegeix portal Consorci AOC (~893 datasets de diputacions, ajuntaments, consells comarcals)
178
+ - Cobertura total: ~2.600 datasets, ~2.400 queryables
179
+ - Inclou dades de les diputacions de Tarragona, Girona i Lleida
180
+
181
+ ### v0.0.6 (2026-04-12)
182
+ - Afegeix client CIDO (api.diba.cat) per contractacions, normatives, subvencions, oposicions, convenis
183
+ - Camps filtables reals extrets automaticament per cada endpoint CIDO
184
+
185
+ ### v0.0.5 (2026-04-12)
186
+ - Gestio correcta de datasets no queryables (file_download, restricted)
187
+ - Retorna URL directa en comptes d'error quan un dataset no te API
188
+
189
+ ### v0.0.4 (2026-04-12)
190
+ - Audit complet Barcelona i Diba: api_types correctes per cada dataset
191
+ - Barcelona: resource_id real via package_show (463 queryables)
192
+ - Diba: REST (do.diba.cat) + CIDO (api.diba.cat) + file_download
193
+ - Validador d'endpoints a /api/validate.php
194
+
195
+ ### v0.0.3 (2026-04-12)
196
+ - Afegeix client Diba (do.diba.cat REST API) amb paginacio i filtres
197
+
198
+ ### v0.0.2 (2026-04-12)
199
+ - Afegeix referencia al projecte datagouv-mcp del govern frances
200
+
201
+ ### v0.0.1 (2026-04-12)
202
+ - Versio inicial: 3 portals (Generalitat, Barcelona, Diba)
203
+ - 6 tools: search_datasets, get_dataset_info, list_dataset_fields, query_dataset, list_portals, list_categories
204
+ - Publicat a npm com @opendata.cat/mcp-server
205
+
165
206
  ## Llicencia
166
207
 
167
208
  MIT
package/dist/index.js CHANGED
@@ -1,6 +1,8 @@
1
1
  #!/usr/bin/env node
2
+ import { createServer } from "node:http";
2
3
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
4
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
5
+ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
4
6
  import { z } from "zod";
5
7
  import { searchDatasets, getDatasetInfo, getCategories } from "./api.js";
6
8
  import { querySocrata } from "./clients/socrata.js";
@@ -9,7 +11,7 @@ import { queryDiba } from "./clients/diba.js";
9
11
  import { queryCido } from "./clients/cido.js";
10
12
  const server = new McpServer({
11
13
  name: "opendata-cat",
12
- version: "0.0.6",
14
+ version: "0.0.8",
13
15
  });
14
16
  // Tool 1: search_datasets
15
17
  server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. Retorna nom, descripció, portal i formats.", {
@@ -130,7 +132,42 @@ server.tool("list_categories", "Llista totes les categories i temes de datasets
130
132
  return { content: [{ type: "text", text: JSON.stringify(cats, null, 2) }] };
131
133
  });
132
134
  async function main() {
133
- const transport = new StdioServerTransport();
134
- await server.connect(transport);
135
+ const mode = process.argv.includes("--http") ? "http" : "stdio";
136
+ const port = parseInt(process.env.MCP_PORT || "3100", 10);
137
+ if (mode === "http") {
138
+ const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
139
+ const httpServer = createServer(async (req, res) => {
140
+ // CORS
141
+ res.setHeader("Access-Control-Allow-Origin", "*");
142
+ res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
143
+ res.setHeader("Access-Control-Allow-Headers", "Content-Type");
144
+ if (req.method === "OPTIONS") {
145
+ res.writeHead(204);
146
+ res.end();
147
+ return;
148
+ }
149
+ // Health check
150
+ if (req.url === "/health") {
151
+ res.writeHead(200, { "Content-Type": "application/json" });
152
+ res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.8" }));
153
+ return;
154
+ }
155
+ // MCP endpoint
156
+ if (req.url === "/mcp") {
157
+ await transport.handleRequest(req, res);
158
+ return;
159
+ }
160
+ res.writeHead(404);
161
+ res.end("Not found");
162
+ });
163
+ await server.connect(transport);
164
+ httpServer.listen(port, () => {
165
+ console.log(`MCP HTTP server running on port ${port}`);
166
+ });
167
+ }
168
+ else {
169
+ const transport = new StdioServerTransport();
170
+ await server.connect(transport);
171
+ }
135
172
  }
136
173
  main().catch(console.error);
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "publishConfig": {
4
4
  "access": "public"
5
5
  },
6
- "version": "0.0.6",
6
+ "version": "0.0.8",
7
7
  "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
8
8
  "type": "module",
9
9
  "main": "dist/index.js",
@@ -25,6 +25,7 @@
25
25
  ],
26
26
  "author": "opendata.cat",
27
27
  "license": "MIT",
28
+ "mcpName": "io.github.xaviviro/opendata-cat",
28
29
  "repository": {
29
30
  "type": "git",
30
31
  "url": "git+https://github.com/xaviviro/Opendata.cat-MCP-Server.git"