Catalunya 2022 MCP server

Servidor MCP de Catalunya 2022

Servidor MCP remot per al document «Catalunya 2022 - RESET: Crida per reactivar el país», el pla estratègic elaborat l'any 2021 per un grup de treball de 30 experts de la societat civil catalana. Exposa els 3 àmbits, els 12 objectius, les 91 accions i els perfils dels contribuïdors en català, anglès i castellà mitjançant eines, recursos i prompts MCP.

Connexió

Endpoint públic: https://mcp.2022.cat (transport Streamable HTTP, sense autenticació ni claus API). El servidor parla les dues generacions del protocol des d'un sol endpoint: la revisió 2026-07-28 (sense handshake, amb server/discover) i les revisions 2025-xx per als clients que encara fan initialize.

{ "url": "https://mcp.2022.cat" }

• Instruccions per client (Claude, ChatGPT, Cursor, VS Code, Cline, Continue…): 2022.cat/mcp
• Registre MCP oficial: cat.2022/catalunya-2022
• Lloc web del document: 2022.cat · repositori

Superfície MCP pública

Eines

• search_document: cerca de text complet amb suport de diacrítics
• get_section: text complet de qualsevol secció per slug canònic
• getdocumentmetadata: estructura completa del document
• list_proposals: llistat de les 91 accions

Recursos

• document://catalunya2022/manifest
• document://catalunya2022/{locale}/{slug}
• document://catalunya2022/{locale}: el document sencer en un sol fitxer markdown
• document://catalunya2022/contributors

Prompts

• explore-document
• summarize-sphere
• analyze-proposal

Desenvolupament

Requisits: Node.js 22+ i npm.

npm install
npm run dev

npm run dev regenera el corpus abans d'iniciar el servidor local:

• http://localhost:3001/: endpoint MCP
• http://localhost:3001/health: comprovació de salut

Comprovacions de qualitat

npm run lint        # format i lint amb Biome
npm run typecheck   # TypeScript estricte (inclou locals i paràmetres no usats)
npm run test        # reconstrueix corpus i dist, executa la suite de regressió
npm run verify      # validació completa local, equivalent a CI

Altres ordres: npm run build-corpus (regenera data/corpus.json des de l'MDX), npm run start (executa el servidor compilat), npm run fixtures:update (regenera els fixtures daurats de tests/fixtures/; revisa el diff resultant), i npm run sync / npm run sync-check (vegeu la nota sobre contingut sincronitzat).

Executa npm run verify abans d'obrir un pull request. Els tests s'executen contra la sortida compilada a dist/: fes servir sempre els scripts npm, que reconstrueixen primer.

Estructura del projecte

assets/         Icones del servidor (servides a /icon.svg i /icon.png)
content/        Fitxers MDX trilingües d'origen
data/           Constants, tipus, catàleg de rutes, contribuïdors, corpus generat
scripts/        Generació del corpus, sincronització de contingut i regeneració de fixtures
src/            Runtime del servidor MCP
tests/          Tests de contracte, regressió i utilitats
server.json     Manifest per al registre MCP oficial

Contingut sincronitzat

Shortened. The full README is on GitHub.