Catalunya 2022

Catalunya 2022 MCP 服务

面向文档 《Catalunya 2022 - RESET: Crida per reactivar el país》 的远程 MCP 服务。这是由加泰罗尼亚公民社会的 30 位专家组成的工作组于 2021 年制定的战略计划。服务通过 MCP 工具、资源和提示词，以加泰罗尼亚语、英语和西班牙语提供 3 个领域、12 个目标、91 项行动及贡献者简介。

连接

公共端点：https://mcp.2022.cat（Streamable HTTP 传输，无需身份验证或 API 密钥）。服务通过单个端点支持两代协议：2026-07-28 修订版（无需握手，支持 server/discover）以及仍使用 initialize 的客户端所用的 2025-xx 修订版。

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

• 各客户端的说明（Claude、ChatGPT、Cursor、VS Code、Cline、Continue…）：2022.cat/mcp
• 官方 MCP 注册表：cat.2022/catalunya-2022
• 文档网站：2022.cat · 代码仓库

公共 MCP 接口

工具

• search_document：支持变音符号的全文搜索
• get_section：根据规范 slug 获取任意章节的全文
• get_document_metadata：获取文档的完整结构
• list_proposals：列出 91 项行动

资源

• document://catalunya2022/manifest
• document://catalunya2022/{locale}/{slug}
• document://catalunya2022/{locale}：将整份文档放在单个 markdown 文件中
• document://catalunya2022/contributors

提示词

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

开发

要求：Node.js 22+ 和 npm。

npm install
npm run dev

npm run dev 会在启动本地服务前重新生成语料库：

• http://localhost:3001/：MCP 端点
• http://localhost:3001/health：健康检查

质量检查

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

其他命令：npm run build-corpus（从 MDX 重新生成 data/corpus.json）、npm run start（运行编译后的服务）、npm run fixtures:update（重新生成 tests/fixtures/ 中的黄金测试样例；请检查生成的差异），以及 npm run sync / npm run sync-check（参见同步内容说明）。

提交 pull request 前，请运行 npm run verify。测试针对 dist/ 中的编译输出运行：请始终使用 npm 脚本，它们会先重新构建。

项目结构

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

同步内容

content/{ca,en,es}/ 和 data/team-members.ts 是网站代码仓库生成的镜像，该仓库是文档文本的事实来源。请勿在此处编辑这些文件：所有更改都必须在源代码仓库中进行，并通过 npm run sync 同步（该命令会在 data/content-provenance.json 中记录来源）。默认情况下，网站代码仓库位于 ../web（克隆到本仓库旁边）；环境变量 CAT22_WEBSITE_DIR 可用于指定其他位置。若相邻仓库可用，npm run sync-check 会检测差异；若不可用（例如在 CI 中），则会静默跳过。

发布说明

• 规范 slug 始终使用英文，即使内容已本地化也不例外。
• 默认语言为加泰罗尼亚语（ca）。
• 生成的文件 data/corpus.json 不纳入版本控制：npm run dev、npm run build 和 npm test 会根据已纳入版本控制的 MDX 重新生成该文件，CI 会在每次部署时对其进行验证。
• 公开契约：MCP 工具名称、资源 URI、提示词名称、规范 slug、JSON 响应格式和默认 locale 都是公开 API。未经明确且有文档记录的意图，不要更改这些内容。
• 如果更改 content/、data/ 或 URL 翻译逻辑，请重新生成语料库，并仔细检查回归测试 fixture。

---

English

面向政策文件 《加泰罗尼亚 2022 - RESET：呼吁重新激活加泰罗尼亚》 的远程 MCP 服务。这是一项于 2021 年由 30 位专家组成的加泰罗尼亚公民社会工作组制定的战略计划。该服务通过 MCP 工具、资源和提示词，以加泰罗尼亚语、英语和西班牙语提供文件中的 3 个领域、12 个目标、91 项行动及贡献者简介。

连接：公开端点 https://mcp.2022.cat（Streamable HTTP，无需身份验证）：

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

各客户端的设置说明：2022.cat/mcp · 官方 MCP Registry：cat.2022/catalunya-2022 · 文件网站：2022.cat · 网站代码：github.com/catalunya-2022/web · 已归档文件的 DOI：10.5281/zenodo.19500831

开发命令不受语言影响；请参阅上文的开发。

许可证

• 代码 / Code：MIT
• 文件内容 / Document content（content/）：CC BY 4.0 - Grup de Treball Catalunya 2022。《Catalunya 2022 - RESET: Crida per reactivar el país.》DOI：10.5281/zenodo.19500831