Salta al contingut principal

Opendata.cat MCP Server

Connecta el teu assistent d'IA (Claude, ChatGPT, Gemini...) amb més de 2.500 datasets de dades obertes públiques de Catalunya. Cerca, explora i consulta dades reals directament des del teu LLM.

Què és un MCP?

El Model Context Protocol (MCP) és un estàndard obert que permet als models de llenguatge accedir a eines i fonts de dades externes. Amb el nostre MCP, qualsevol LLM pot cercar, explorar i consultar les dades obertes catalanes de forma natural.

Inspirat en el projecte datagouv-mcp del govern francès, opendata.cat ofereix un servidor MCP adaptat al context català i mantingut per la nostra associació.

Portals disponibles

Generalitat de Catalunya

1.058

datasets · Socrata

Ajuntament de Barcelona

555

datasets · CKAN

Diputació de Barcelona

90

datasets · REST

Consorci AOC

~893

datasets · CKAN

El Consorci AOC inclou dades de les diputacions de Tarragona, Girona i Lleida, ajuntaments, consells comarcals i altres organismes públics catalans.

~2.400 datasets queryables directament amb filtres i paginació (Socrata, CKAN, REST, CIDO). La resta ofereix descàrrega directa de fitxers (CSV, JSON, GIS). Cada endpoint és validat automàticament.

Instal·lació ràpida

Claude Desktop

Afegeix al fitxer de configuració:

{
  "mcpServers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Claude Code (CLI)

claude mcp add opendata-cat -- npx -y @opendata.cat/mcp-server

VS Code / Cursor

Afegeix al fitxer .vscode/mcp.json:

{
  "servers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Tools disponibles

search_datasets

Cerca datasets per text lliure al catàleg de +1.700 datasets. Filtra per portal o categoria.

get_dataset_info

Retorna metadades completes d'un dataset: camps, tipus, llicència, endpoint API.

list_dataset_fields

Llista els camps d'un dataset amb nom, tipus i descripció.

query_dataset

Consulta dades reals directament al portal origen. Suporta filtres, cerca i paginació.

list_portals

Llista els portals disponibles amb el nombre de datasets de cadascun.

list_categories

Llista categories i temes disponibles amb comptadors per portal. Ideal per descobrir quins tipus de dades hi ha.

Exemples d'ús

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"

"Quin és l'estat dels embassaments de Catalunya?"

"Dona'm les últimes dades de pressupostos municipals"

"Quines dades obertes hi ha sobre educació a Catalunya?"

Com funciona

Usuari

pregunta

LLM

interpreta

MCP opendata.cat

catàleg + consulta

Portal origen

dades reals

L'MCP consulta l'API d'opendata.cat per descobrir datasets rellevants i fa consultes directament als portals origen (Socrata, CKAN). No emmagatzema ni fa de proxy de dades.

Hi trobes a faltar dades?

Si coneixes un portal de dades obertes que no tenim indexat, proposa'l i l'analitzarem automaticament.

Proposa una font de dades

Codi obert

El projecte es de codi obert i esta publicat a npm. Les contribucions son benvingudes: afegir nous portals, millorar la cerca, reportar errors.

npx -y @opendata.cat/mcp-server