Opendata.cat MCP Server

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

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

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)

~10

datasets · CKAN + GTFS-RT JSON

FGC i Renfe Rodalies inclouen trens en temps real (GTFS-RT). Idescat proporciona indicadors estadístics amb sèries temporals. El Consorci AOC inclou dades de diputacions, ajuntaments i consells comarcals.

Més de 2.800 datasets de 9 portals catalans 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: Program → 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

Connecta directament amb Claude, ChatGPT 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+.

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.

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

Un cop configurat, pots fer preguntes al teu LLM com:

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

"Hi ha algun tren de FGC amb retard ara mateix?"

"Quins trens de Rodalies porten retard ara?"

"Analitza la qualitat de l'aire a Terrassa"

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

"Compara Girona i Tarragona en dades obertes"

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

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

"Analitza les actuacions dels Bombers al Vallès"

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

Claude Desktop (macOS / Windows)

Claude Code (CLI)

VS Code / Cursor

Gemini CLI

ChatGPT (via MCP URL)

Smithery.ai

Tools disponibles

Exemples d'ús

Com funciona

Hi trobes a faltar dades?

Codi obert