mcp-reunion

mcp-reunion 是一个 MCP（Model Context Protocol）服务器，用于暴露留尼汪岛（La Réunion，法国海外省）的公共开放数据，通过 stdio 传输供 Claude Desktop 及其他 MCP 客户端调用。

主要数据源为 data.regionreunion.com 上的 OpenDataSoft Explore v2.1 API。另有一个小型“国家选举”模块查询 tabular-api.data.gouv.fr，用于补充区域门户未收录的 2024 年提前立法选举与欧洲选举结果。当前共提供 108 个工具，分布在 26 个模块中。

模块与用途大致包括：

• 行政：公共行政本地名录、RNA 协会登记、民选官员、2022 年总统与立法选举各投票站结果、BOAMP 公共采购公告、QPV 优先社区、2000 年以来的婴儿姓名。
• 市镇：reunion_find_commune（模糊解析到 INSEE 规范代码）、reunion_commune_profile（一次调用汇总人口、QPV、学校、企业、事故、博物馆）、reunion_compare_communes（2–5 个市镇对比）、reunion_iris_profile（IRIS 元数据及 2014 年收入/贫困/不平等指标）。
• 文化：法国博物馆名录、Joconde 藏品检索、公共图书馆、节庆、年度博物馆参观量。
• 经济：SIRENE v3 机构检索、INSEE 月度 CPI、FEDER 2014–2020 受益方、共享办公空间、IRIS 级收入/贫困指标。
• 教育：初中与高中 IPS、Génération 2024 标签、Parcoursup 课程、地理定位学校目录、REP/REP+ 优先教育学校、高等教育注册、培训机构/CFA。
• 就业：按年龄/性别及市镇统计的求职者人数。
• 环境：OpenAQ 空气质量、生活垃圾吨位、RGE 生态翻新企业、ZNIEFF 保护区、国家公园范围、石油产品消费、水管理兴趣点。
• 设施：INSEE BPE 设施与全国体育设施清单（筛选留尼汪）。
• 地理：BAN/BAL 地址及官方市镇/县/EPCI/IRIS/圣但尼街区参考图层。
• 健康：CNAM 卫生专业人员目录、COVID 统计、病理、FINESS、Possession 卫生专业人员。
• 遗产：留尼汪国家公园的 UNESCO 世界遗产范围及突出普遍价值标准 vii 贡献区域。
• 酒店与旅游：旅游机构、分类住宿、生态旅馆区域。
• 洞察：按市镇和旅游的公共服务高层复合仪表板。
• 国家选举：2024 年提前立法选举（两轮）按留尼汪选区、2024 年欧洲选举按 974 省汇总。
• 附近：按坐标半径搜索学校、Car Jaune 站点、官方博物馆。
• 住房：省级住房地图与社会住房成本。
• Possession：公共采购合同与协会补贴。
• 路由：reunion_find_relevant_tools，将自然语言问题映射到可能的工具、数据集与查询流程。
• 社会：CAF 受益人与津贴金额、托儿设施（圣但尼 + Possession）。
• 电信：各运营商 5G 站点与 FttH 部署覆盖。
• 领地：DVF 房地产交易、INSEE 市镇人口、La Poste 邮编、土地储备潜力、Sitadel 住宅建设许可。
• 旅游：家庭步道、溪降路线、SIT Soubik 地标与文化 POI、徒步线路、海岸步道、泳池、2017 年以来月度旅游客流。
• 交通：TMJA 道路交通、功能性道路分类、Car Jaune GTFS 站点/线路及规划背景、区域自行车网络、道路事故（2016–2019）、车辆技术检验价格、国道日流量与限速。
• 城市规划：PLU 分区与非住宅建筑许可（Sitadel）。
• 天气：Météo France SYNOP 观测（温度、湿度、风、气压、降雨）及站点列表工具。
• 目录（meta）：search_catalog、inspect_dataset、query_dataset，可发现并查询未被专用模块覆盖的约 270 个数据集，支持原始 ODSQL where 子句。

使用方式：

• 通过 stdio 运行，面向 Claude Desktop 等 MCP 客户端。
• 运行时要求 Node.js 20+。
• 上游 API 为 https://data.regionreunion.com/api/explore/v2.1，无需认证。
• 源数据语言主要为法语。

目录模块与长尾数据集： 门户约有 270 个数据集，专用模块覆盖最常见主题。对于长尾问题（如火山学、选举、图书馆到访量等），可依次使用 reunion_search_catalog 搜索目录、reunion_inspect_dataset 查看数据集 schema、reunion_query_dataset 以原始 ODSQL where/select/order_by/limit 取记录。常被查询的数据集可被提升为专属模块。

资源与提示词示例： 服务器还暴露静态 MCP 资源：reunion://communes、reunion://datasets/catalog、reunion://datasets/popular。示例提示词位于 examples/ 目录，包括 claude-desktop.md（安装与首批提示）、civic-analysis.md（市镇与采购分析）、elections.md（2022 与 2024 选举分析）、tourism.md（旅游与户外活动提示）、transport.md（道路与公交提示）。

扩展与维护： 每个模块位于 src/modules/，通过共享 ReunionClient（src/client.ts）将 OpenDataSoft 数据集接入一个或多个 MCP 工具。新增模块的步骤：在目录 API 中确定数据集 ID、查看字段、按 src/modules/weather.ts 或 transport.ts 的模式编写模块、在 src/modules/index.ts 注册并更新 TOOL_COUNT。 维护检查：npm run check:schema 验证 schema-expectations.json 中列出的高价值上游数据集字段；npm run docs:coverage 重新生成 COVERAGE.md。输出约定见 docs/output-contracts.md，发布自动化见 docs/release.md。

可选本地遥测： 工具调用遥测默认关闭。如需在本地调试使用模式而不向远程服务发送数据，可启用后默认写入 .mcp-reunion-telemetry.jsonl 的 JSONL 记录，路径可用 MCP_REUNION_TELEMETRY_PATH 覆盖。

许可：MIT，改编自 lacausecrypto/mcp-new-caledonia。