mcp-reunion

用于留尼汪岛公共开放数据的 MCP 服务器，通过 stdio 为 Claude Desktop 及其他 MCP 客户端提供服务。

覆盖范围

主要数据源：位于 data.regionreunion.com 的 OpenDataSoft Explore v2.1 API。此外，一个小型全国选举模块还会查询 tabular-api.data.gouv.fr，以获取区域门户网站未包含的 2024 年提前立法选举及欧洲议会选举结果。目前共有 22 个模块，包含 99 个工具。通过目录 (catalog) 模块，客户端可以访问 data.regionreunion.com 上约 270 个尚未关联到专用工具的数据集。

Related MCP server: mcp-brasil

模块

• 行政 (Administration) — 公共行政本地计数器 (annuaire)、RNA 协会注册、民选官员、2022 年总统及立法选举各投票站结果（立法选举第 1 和第 2 轮）、BOAMP 公共采购公告、QPV 优先社区、2000 年以来的婴儿姓名。

• 市镇 (Commune) — 并行连接多个数据集的复合工具：reunion_find_commune（模糊解析至标准 INSEE 代码）、reunion_commune_profile（单次调用获取人口 + QPV + 学校 + 企业 + 事故 + 博物馆信息）、reunion_compare_communes（2-5 个市镇并排对比）、reunion_iris_profile（IRIS 元数据 + 2014 年收入/贫困/不平等指标）。

• 文化 (Culture) — 法国博物馆名录、Joconde 藏品搜索、公共图书馆、节日、年度博物馆参观人数。

• 经济 (Economy) — SIRENE v3 企业搜索、INSEE 月度 CPI、FEDER 2014-2020 受益人、联合办公空间、IRIS 级收入/贫困指标。

• 教育 (Education) — 初中和高中 IPS、Génération 2024 标签、Parcoursup 项目、地理定位学校名录、REP/REP+ 优先教育学校、高等教育入学率、培训机构/CFA。

• 就业 (Employment) (demandeurs-d-emploi-…-a-la-reunion) — 按年龄/性别及市镇划分的 Pôle emploi 求职者人数。

• 环境 (Environment) — OpenAQ 空气质量、生活垃圾吨位、RGE 生态翻新公司、ZNIEFF 保护区、国家公园边界、石油产品消耗量、水资源管理兴趣点。

• 设施 (Facilities) (base-permanente-des-equipements-geolocalisee-la-reunion, equipements-sportifs) — INSEE BPE 设施及国家体育设备清单（已过滤至留尼汪岛）。

• 地理 (Geography) (ban-lareunion, bal-la-possession, communes-millesime-france, cantons-millesime-france, intercommunalites-millesime-france, iris-millesime-france, les-20-quartiers-villesaintdenis) — BAN/BAL 地址以及官方市镇/县/EPCI/IRIS/圣但尼街区参考图层。

• 健康 (Health) — CNAM 医疗专业人员名录、COVID 统计数据、病理学、FINESS、Possession 医疗专业人员。

• 酒店业 (Hospitality) (etablissements-touristiques-lareunion-wssoubik, hebergements-classespublic, localisation-potentielle-ecolodge-lareunion) — 旅游机构、星级住宿、生态旅馆区域。

• 全国选举 (National elections) (tabular-api.data.gouv.fr — 内政部) — 2024 年留尼汪各选区提前立法选举结果（第 1 和第 2 轮），以及 974 省汇总的 2024 年欧洲议会选举结果。补充了区域门户网站提供的 2022 年选举结果。

• 住房 (Housing) (logements-et-logements-sociaux-…, couts-et-surfaces-moyens-…) — 省级住房地图集和社会住房成本。

• Possession (donnees-essentielles-marches-publics-…, subventions-attribuees-…) — La Possession 市的公共采购合同和协会补助金。

• 社会 (Social) — CAF 受益人及福利金额、托儿设施（圣但尼 + Possession）。

• 电信 (Telecom) (sites-mobiles-5g-a-la-reunion, arcep_regions) — 各运营商的 5G 基站及 FttH 部署覆盖范围。

• 领土 (Territory) — DVF 房地产交易、INSEE 市镇人口、La Poste 邮政编码、potentiel foncier 土地储备、Sitadel 住宅建筑许可。

• 旅游 (Tourism) — 家庭步道、溪降路线、SIT Soubik 地标及文化兴趣点、徒步线路、海岸步道、游泳池、2017 年以来的月度旅游人次。

• 交通 (Transport) — TMJA 道路交通、功能性道路分类、Car Jaune GTFS 站点/路线、区域自行车网络、道路交通事故 (2016-2019)、车辆技术检查价格、国道每日流量及限速。

• 城市规划 (Urbanism) (base-permanente-des-plu-de-la-reunion, liste-des-permis-de-constuire-…) — PLU 分区及非住宅建筑许可 (Sitadel)。

• 天气 (Weather) (donnees-synop-essentielles-ommpublic) — 留尼汪气象站的 Météo France SYNOP 观测数据：温度、湿度、风速、气压、降雨量；以及站点列表工具。

• 目录 (Catalog) (元数据) — search_catalog, inspect_dataset, query_dataset。允许代理发现并查询约 270 个尚未关联到专用工具的数据集，并支持使用原始 ODSQL where 子句作为出口。

data.regionreunion.com 目录公开了约 270 个数据集。更多模块可以逐步添加 — 请参阅下方的扩展部分。

访问尚未关联的数据集

上述专用模块涵盖了最常被问及的主题，但门户网站总共有约 270 个数据集。为了避免为每个长尾问题编写新模块，目录 (catalog) 模块为 MCP 客户端提供了三个通用工具，作为访问整个门户网站的出口：

1. reunion_search_catalog — 在所有数据集中进行关键词/主题/发布者搜索。返回数据集 ID、标题、描述和记录数。

2. reunion_inspect_dataset — 给定数据集 ID，返回其完整架构（字段名称 + 类型），以便代理了解可过滤的内容。

3. reunion_query_dataset — 使用原始 ODSQL where 子句、select、order_by、limit 从任何数据集获取记录。

当用户询问没有专用模块覆盖的内容（例如火山学、选举、图书馆出勤率等）时的典型流程：

reunion_search_catalog({ query: "volcan" })
  → returns e.g. dataset_id "suivi-volcanologique-piton-fournaise"
reunion_inspect_dataset({ dataset_id: "suivi-volcanologique-piton-fournaise" })
  → returns fields like date, type_evenement, magnitude, profondeur…
reunion_query_dataset({
  dataset_id: "suivi-volcanologique-piton-fournaise",
  where: "type_evenement = 'éruption' AND date >= date'2023-01-01'",
  order_by: "date DESC",
  limit: 20
})

最终效果：代理可以在无需任何人编写新模块的情况下，回答由约 270 个数据集中的任何一个支持的问题。通过 query_dataset 证明受欢迎的数据集，将有资格被提升为具有特定字段名称的专用模块。

安装

npm install
npm run build
npm test
npm run dev

Claude Desktop

{
  "mcpServers": {
    "reunion": {
      "command": "npx",
      "args": ["mcp-reunion"]
    }
  }
}

扩展

每个模块位于 src/modules/ 中，并通过共享的 ReunionClient (src/client.ts) 将 OpenDataSoft 数据集连接到一个或多个 MCP 工具。要添加模块：

1. 在 https://data.regionreunion.com/api/explore/v2.1/catalog/datasets?limit=100 确定数据集 ID。

2. 检查其字段 (/catalog/datasets/<id>) 以了解要公开的内容。

3. 按照 src/modules/weather.ts 或 transport.ts 中的模式编写模块。

4. 在 src/modules/index.ts 中注册它，并增加 TOOL_COUNT。

生产说明

• 运行时：Node.js 18+

• 传输：stdio

• 上游 API：https://data.regionreunion.com/api/explore/v2.1

• 身份验证：无

• 源数据语言：主要是法语

许可证

MIT — 改编自 lacausecrypto/mcp-new-caledonia。