Opendata.cat MCP Server

Name: Opendata.cat MCP Server
Author: opendata.cat

Connecta el teu assistent d'IA (Claude, ChatGPT, Gemini...) amb +2.850 datasets de dades obertes de Catalunya i fonts estatals (INE, REE, CNMC). Dades de +1.000 municipis, trens en temps real, preus electricitat i carburants.

GitHub npm

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ó.

Fonts de dades

Portals amb API queryable — pots consultar dades reals amb filtres i paginació:

Generalitat de Catalunya

1.059

datasets · Socrata

Consorci AOC

~887

datasets · CKAN

Ajuntament de Barcelona

555

datasets · CKAN

Idescat

138

indicadors · Idescat API

Diputació de Barcelona

90

datasets · REST + CIDO

Ajuntament de Girona

53

datasets · CKAN

FGC (Ferrocarrils)

50

datasets · Opendatasoft + GTFS-RT

Ajuntament de Reus

119

datasets · CKAN

Renfe (Rodalies)

6

datasets · CKAN + GTFS-RT JSON

Fonts estatals espanyoles amb focus Catalunya:

INE (Estadística)

6

Població, IPC, EPA, turisme, PIB, habitatge

Red Eléctrica (REE)

4

Generació, demanda, preus PVPC temps real

SEPE (Ocupació)

2

Atur i contractes per municipis

CNMC (Carburants)

1

Preus gasolina/dièsel ~1.500 gasolineres CAT

FGC i Renfe Rodalies inclouen trens en temps real (GTFS-RT). Idescat proporciona indicadors estadístics. INE: estadística oficial (població, IPC, turisme, PIB). REE: generació i preus d'electricitat. SEPE: atur per municipis. CNMC: preus de carburants.

Més de 2.850 datasets de 13 portals (9 catalans + 4 estatals amb focus Catalunya) i dades de +1.000 municipis via AOC.

Amb models locals (pesos oberts)

Executa models d'IA al teu ordinador, sense enviar dades a cap servidor extern. Ideal per a privacitat i sobirania de dades.

Model recomanat per al català: Qwen 3.5 9B — el millor model obert en català segons l'avaluació de Softcatalà. Alternatives: Gemma 3 12B, Mistral Small 3.1 24B. Cal suport de tool calling i almenys 9B paràmetres.

LM Studio

LM Studio suporta MCP nativament des de la v0.3.17. Edita el fitxer ~/.lmstudio/mcp.json (macOS/Linux) o %USERPROFILE%\.lmstudio\mcp.json (Windows):

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

També pots configurar-lo des de la interfície: Integrations → Install → Edit mcp.json.

Requereix Node.js 18+.

Ollama (via MCPHost)

Ollama no té suport MCP natiu, però pots usar MCPHost com a pont:

1. Instal·la MCPHost:

go install github.com/mark3labs/mcphost@latest

2. Crea el fitxer mcp-servers.json:

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

3. Executa amb el teu model preferit:

mcphost -m ollama:qwen3.5:9b --config mcp-servers.json

Streamable HTTP (qualsevol client)

Si el teu client MCP local suporta connexió HTTP remota, pots connectar-te directament sense instal·lar res:

https://opendata.cat/api/mcp

Suporta Streamable HTTP (SSE + JSON-RPC), sessions via Mcp-Session-Id, i no requereix autenticació.

Compatible amb qualsevol client que implementi el protocol MCP sobre HTTP. Registrat al registre oficial MCP com io.github.xaviviro/opendata-cat.

Amb models propietaris i editors

Connecta amb Claude, ChatGPT, Gemini, Copilot Studio, editors d'IA o via plataformes com Smithery.

Claude Desktop (macOS / Windows)

Afegeix al fitxer de configuració (~/Library/Application Support/Claude/claude_desktop_config.json a macOS o %APPDATA%\Claude\claude_desktop_config.json a Windows):

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

Requereix Node.js 18+ instal·lat. Reinicia Claude Desktop després de guardar.

Claude Code (CLI)

Executa al terminal:

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

S'activa immediatament. Pots verificar-ho amb claude mcp list.

VS Code / Cursor

Afegeix al fitxer .vscode/mcp.json del teu projecte:

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

Funciona amb Copilot Chat (VS Code) i Cursor AI. Requereix Node.js 18+.

Windsurf

Windsurf (ex-Codeium) suporta MCP nativament. Edita el fitxer ~/.codeium/windsurf/mcp_config.json (macOS/Linux) o %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):

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

O connecta via HTTP remot sense instal·lar res:

{
  "mcpServers": {
    "opendata-cat": {
      "serverUrl": "https://opendata.cat/api/mcp"
    }
  }
}

També pots afegir-lo des de la interfície: icona MCP al panell Cascade → Configure. Documentació oficial.

JetBrains (IntelliJ, PyCharm, WebStorm...)

AI Assistant de JetBrains suporta MCP. Configura des de Settings → Tools → AI Assistant → Model Context Protocol (MCP):

Ves a Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Fes clic a Add → selecciona STDIO
Enganxa la configuració JSON:

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

O selecciona HTTP i usa la URL remota:

https://opendata.cat/api/mcp

Requereix JetBrains 2025.1+ amb AI Assistant activat. Documentació oficial.

Cline (VS Code)

Cline suporta MCP nativament. A la barra lateral de Cline, ves a MCP Servers → Configure per obrir cline_mcp_settings.json i afegeix:

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

O connecta via URL remota (sense instal·lació local):

{
  "mcpServers": {
    "opendata-cat": {
      "url": "https://opendata.cat/api/mcp"
    }
  }
}

Requereix l'extensió Cline per a VS Code. Documentació oficial.

Continue (VS Code / JetBrains)

Continue suporta MCP via config.yaml. Afegeix al fitxer de configuració (~/.continue/config.yaml):

mcpServers:
  - name: opendata-cat
    command: npx
    args:
      - "-y"
      - "@opendata.cat/mcp-server"

O connecta via URL remota:

mcpServers:
  - name: opendata-cat
    url: https://opendata.cat/api/mcp

Funciona amb VS Code i JetBrains. Open source. Documentació oficial.

Warp (Terminal)

Warp suporta MCP nativament. Configura des de Settings → AI → MCP Servers:

Ves a Settings → AI → MCP Servers
Fes clic a + Add
Selecciona URL i enganxa:

https://opendata.cat/api/mcp

O configura via JSON amb el paquet npm:

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

La configuració MCP es sincronitza entre dispositius amb el compte Warp. Documentació oficial.

Gemini CLI

Gemini CLI suporta MCP nativament. Afegeix al fitxer ~/.gemini/settings.json:

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

Alternativament, pots usar la connexió HTTP remota sense instal·lar res:

{
  "mcpServers": {
    "opendata-cat": {
      "url": "https://opendata.cat/api/mcp"
    }
  }
}

Requereix Node.js 18+ per a la versió stdio. La versió HTTP no requereix instal·lació local.

Microsoft Copilot Studio

Copilot Studio suporta MCP via Streamable HTTP. Connecta directament amb la URL del servidor:

https://opendata.cat/api/mcp

Passos:

Ves a la pàgina Tools del teu agent
Selecciona Add a tool → New tool → Model Context Protocol
Omple els camps:
- Server name: opendata-cat
- Server description: Catalan open data — 2,800+ datasets from 9 portals
- Server URL: https://opendata.cat/api/mcp
Autenticació: selecciona None (no requereix clau)
Selecciona Create → Create a new connection → Add to agent

Requereix Generative Orchestration activat a l'agent. Les tools es sincronitzen automàticament quan s'actualitzen al servidor. Documentació oficial.

ChatGPT (via MCP URL)

ChatGPT suporta MCP via URL directa:

https://opendata.cat/api/mcp

Passos:

Ves a Settings → Connected apps → MCP
Afegeix un nou servidor MCP
Enganxa la URL: https://opendata.cat/api/mcp
Confirma la connexió

No requereix instal·lació local. Funciona directament des del navegador.

Tools disponibles

search_datasets

Cerca datasets per text lliure al catàleg de +2.800 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.

related_datasets

Retorna datasets relacionats d'altres portals. Ideal per descobrir dades complementàries entre Generalitat, Barcelona, Diba, AOC, FGC, Renfe i més.

La cerca inclou sinònims en català i castellà per trobar més resultats rellevants.

Exemples d'ús per font

Un cop configurat, pots fer preguntes al teu LLM. Aquí tens exemples organitzats per font de dades:

Generalitat, Barcelona, Diba, Idescat

Medi ambient, emergències, seguretat, estadística

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

"Analitza la qualitat de l'aire a Terrassa"

"Fes gràfiques amb l'evolució dels accidents de trànsit a Barcelona"

"Analitza les actuacions dels Bombers al Vallès"

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

"Quina és la població de Catalunya segons Idescat?"

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.

L'API REST tambe es publica i documentada: documentacio interactiva (Swagger) · OpenAPI spec

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.

GitHub npm

npx -y @opendata.cat/mcp-server

Opendata.cat MCP Server

Què és un MCP?

Fonts de dades

Amb models locals (pesos oberts)

LM Studio

Ollama (via MCPHost)

Jan

Streamable HTTP (qualsevol client)

Amb models propietaris i editors

Claude Desktop (macOS / Windows)

Claude Code (CLI)

VS Code / Cursor

Windsurf

JetBrains (IntelliJ, PyCharm, WebStorm...)

Cline (VS Code)

Continue (VS Code / JetBrains)

Warp (Terminal)

Gemini CLI

Microsoft Copilot Studio

ChatGPT (via MCP URL)

Smithery.ai

Tools disponibles

Exemples d'ús per font

Generalitat, Barcelona, Diba, Idescat

FGC + Renfe Rodalies

AOC + SEPE — Dades municipals

INE — Estadística oficial

Red Eléctrica — Energia

CNMC — Preus de carburants

Consultes combinades

Com funciona

Hi trobes a faltar dades?

Codi obert