F

Figueres MCP

Dades obertes · Ajuntament de Figueres

Servidor en línia MCP · Streamable HTTP

Dades obertes de Figueres al teu assistent d'IA

Aquest és el punt d'accés públic al servidor MCP de l'Ajuntament de Figueres: des de Cursor o altres clients compatibles pots cercar datasets, veure metadades i consultar taules del DataStore (portal CKAN AOC, codi ENS 1706690004), sense instal·lar res al teu ordinador.

URLs que necessitaràs

Aquesta guia
https://musing-goldwasser.185-219-136-5.plesk.page/
Endpoint MCP
https://musing-goldwasser.185-219-136-5.plesk.page/mcp
Prova ràpida
/health — ha de respondre "ok": true
Com connectar-s'hi Eines disponibles

Per a què serveix

El portal de dades obertes té molts conjunts de dades; amb aquest MCP l'assistent fa de pont amb el catàleg i el DataStore de Figueres: menys clics, més context i respostes estructurades (sovint en JSON) que pots resumir o analitzar al xat.

Eines MCP exposades

No cal recordar els noms: digues a l'assistent què vols (p. ex. «cerca datasets sobre medi ambient») i ell triarà l'eina adequada. Aquí tens el mapa ràpid per si vols ser explícit.

Eina Funció
llista_datasets Llista datasets de Figueres amb paginació (nom, descripció, data d'actualització).
cerca_datasets Cerca per paraula clau dins el catàleg filtrat per a l'organització de Figueres.
detall_dataset Metadades completes, recursos, llicència i si el recurs és consultable per API (DataStore).
consulta_dades Llegeix registres d'un recurs per UUID: limit, offset, filtres per columna i cerca opcional.
dades_figueres_filtrades Igual que la consulta però fixant CODI_ENS a Figueres; útil per recursos compartits entre municipis.

Font de dades: dadesobertes.seu-e.cat (API CKAN / DataStore AOC).

Com connectar-s'hi (recomanat: remot)

La manera habitual és afegir el servidor per HTTPS al teu client MCP. No cal clonar el repositori ni tenir Node a la màquina local. La disponibilitat de les dades depèn de l'API pública dadesobertes.seu-e.cat.

  1. 1

    Afegeix el servidor al teu editor

    A Cursor (o un client amb MCP per HTTP), obre la configuració d'MCP i crea un servidor amb transport Streamable HTTP / streamableHttp. Enganxa l'URL sencera amb /mcp. 

    {
  "mcpServers": {
    "figueres-dades": {
      "url": "https://musing-goldwasser.185-219-136-5.plesk.page/mcp",
      "transport": "streamableHttp"
    }
  }
}

    Després de guardar, reinicia l'editor o recarrega els MCP si el teu client ho demana.

  2. 2

    Comprova que el backend respongui

    Obre al navegador /health: si veus "ok": true, el servei Node està actiu. Si no carrega, el problema és de xarxa o del hosting, no de la configuració MCP del teu PC.

  3. 3

    Fes preguntes en llenguatge natural

    Exemples que funcionen bé:

    • «Llista'm datasets relacionats amb el pressupost o les ordenances.»
    • «Cerca al catàleg coses de medi ambient o residus.»
    • «Mostra el detall del dataset nom-del-dataset i quins recursos té en CSV o DataStore.»
    • «Consulta dades del recurs amb aquest UUID…» (després de copiar l'ID des del detall).
    • «Vull només registres de Figueres en un dataset multi-municipi (padró, factures…).»

Clients només amb STDIO (sense HTTP)

Alguns entorns (p. ex. Claude Desktop amb configuració clàssica) esperen un comanda local que executi Node. En aquest cas cal clonar el repositori, fer npm install i npm run build, i apuntar el client al fitxer dist/index.js amb un camí absolut. És el mode «desenvolupador» o sense accés al servidor remot.

Desplegament i manteniment (administradors)

El projecte Node s'executa al hosting (p. ex. Plesk: fitxer d'arrencada app.js, que carrega dist/http.js després de npm run build). Es serveixen aquesta pàgina, l'endpoint /mcp i /health. Variables útils: PORT, MCP_HTTP_PATH (per defecte /mcp).