mcp-reunion

Servidor MCP para datos abiertos públicos de La Reunión, expuesto a través de stdio para Claude Desktop y otros clientes MCP.

Qué cubre

Fuente principal: la API OpenDataSoft Explore v2.1 en data.regionreunion.com. Un pequeño módulo de Elecciones nacionales también consulta tabular-api.data.gouv.fr para los resultados de las legislativas anticipadas de 2024 y las europeas, que el portal regional no incluye. Actualmente cuenta con 99 herramientas en 22 módulos. Un módulo de catálogo permite al cliente acceder a cualquiera de los ~270 conjuntos de datos en data.regionreunion.com que aún no están conectados a una herramienta dedicada.

Related MCP server: mcp-brasil

Módulos

• Administración — contadores locales de administración pública (annuaire), registro de asociaciones RNA, funcionarios electos, resultados presidenciales y legislativos de 2022 por mesa electoral (rondas 1 y 2 para legislativas), avisos de contratación pública BOAMP, barrios prioritarios QPV, nombres de bebés desde el año 2000.

• Comuna — herramientas compuestas que combinan varios conjuntos de datos en paralelo: reunion_find_commune (resolutor difuso al código INSEE canónico), reunion_commune_profile (población + QPV + escuelas + empresas + accidentes + museos en una sola llamada), reunion_compare_communes (comparación lado a lado de 2 a 5 comunas), reunion_iris_profile (metadatos IRIS + indicadores de ingresos/pobreza/desigualdad de 2014).

• Cultura — directorio de Musées de France, búsqueda en la colección Joconde, bibliotecas públicas, festivales, asistencia anual a museos.

• Economía — búsqueda de establecimientos SIRENE v3, IPC mensual del INSEE, beneficiarios del FEDER 2014-2020, espacios de coworking, indicadores de ingresos/pobreza a nivel IRIS.

• Educación — IPS de escuelas secundarias y liceos, etiqueta Génération 2024, programas Parcoursup, directorio de escuelas geolocalizadas, escuelas de educación prioritaria REP/REP+, inscripción en educación superior, organizaciones de formación/CFA.

• Empleo (demandeurs-d-emploi-…-a-la-reunion) — recuento de solicitantes de empleo de Pôle emploi por edad/sexo y por comuna.

• Medio ambiente — calidad del aire OpenAQ, tonelaje de residuos domésticos, empresas de eco-renovación RGE, zonas protegidas ZNIEFF, perímetros del Parque Nacional, consumo de productos petrolíferos, puntos de interés de gestión del agua.

• Instalaciones (base-permanente-des-equipements-geolocalisee-la-reunion, equipements-sportifs) — instalaciones BPE del INSEE y el inventario nacional de equipamiento deportivo, filtrado para La Reunión.

• Geografía (ban-lareunion, bal-la-possession, communes-millesime-france, cantons-millesime-france, intercommunalites-millesime-france, iris-millesime-france, les-20-quartiers-villesaintdenis) — direcciones BAN/BAL y las capas de referencia oficiales de comunas / cantones / EPCI / IRIS / barrios de Saint-Denis.

• Salud — directorio de profesionales de la salud de la CNAM, estadísticas de COVID, patologías, FINESS, profesionales de la salud de Possession.

• Hospitalidad (etablissements-touristiques-lareunion-wssoubik, hebergements-classespublic, localisation-potentielle-ecolodge-lareunion) — establecimientos turísticos, alojamientos clasificados, zonas de ecolodge.

• Elecciones nacionales (tabular-api.data.gouv.fr — Ministerio del Interior) — resultados legislativos anticipados de 2024 (rondas 1 y 2) por circunscripción de La Reunión, y resultados europeos de 2024 agregados para el departamento 974. Complementa los resultados de 2022 que ofrece el portal regional.

• Vivienda (logements-et-logements-sociaux-…, couts-et-surfaces-moyens-…) — atlas departamental de vivienda y costes de vivienda social.

• Possession (donnees-essentielles-marches-publics-…, subventions-attribuees-…) — contratos de contratación pública y subvenciones a asociaciones de La Possession.

• Social — beneficiarios de la CAF y montos de prestaciones, instalaciones de cuidado infantil (Saint-Denis + Possession).

• Telecomunicaciones (sites-mobiles-5g-a-la-reunion, arcep_regions) — sitios de telefonía móvil 5G por operador y cobertura de despliegue FttH.

• Territorio — transacciones inmobiliarias DVF, población comunal del INSEE, códigos postales de La Poste, reservas de suelo potentiel foncier, permisos de construcción residencial Sitadel.

• Turismo — senderos familiares, rutas de barranquismo, puntos de interés cultural y SIT Soubik, circuitos de senderismo, sendero costero, piscinas, frecuentación turística mensual desde 2017.

• Transporte — tráfico rodado TMJA, clasificación funcional de carreteras, paradas/rutas de Car Jaune GTFS, red ciclista regional, accidentes de tráfico (2016-2019), precios de inspección técnica de vehículos, flujo diario y límites de velocidad en carreteras nacionales.

• Urbanismo (base-permanente-des-plu-de-la-reunion, liste-des-permis-de-constuire-…) — zonificación PLU y permisos de construcción no residencial (Sitadel).

• Clima (donnees-synop-essentielles-ommpublic) — observaciones SYNOP de Météo France para estaciones de La Reunión: temperatura, humedad, viento, presión, precipitaciones; además de una herramienta de listado de estaciones.

• Catálogo (meta) — search_catalog, inspect_dataset, query_dataset. Permite al agente descubrir y consultar cualquiera de los ~270 conjuntos de datos en data.regionreunion.com que aún no están cubiertos por una herramienta dedicada, con una cláusula where ODSQL sin procesar como vía de escape.

El catálogo data.regionreunion.com expone ~270 conjuntos de datos. Se pueden añadir más módulos de forma incremental; consulte Extensión a continuación.

Acceso a conjuntos de datos que aún no están conectados

Los módulos dedicados anteriores cubren los temas más solicitados, pero el portal tiene ~270 conjuntos de datos en total. En lugar de escribir un nuevo módulo para cada pregunta específica, el módulo de catálogo ofrece al cliente MCP tres herramientas genéricas que actúan como una vía de escape hacia todo el portal:

1. reunion_search_catalog — búsqueda por palabra clave / tema / editor en todos los conjuntos de datos. Devuelve IDs de conjuntos de datos, títulos, descripciones y recuentos de registros.

2. reunion_inspect_dataset — dado un ID de conjunto de datos, devuelve su esquema completo (nombres de campos + tipos) para que el agente sepa qué puede filtrar.

3. reunion_query_dataset — obtiene registros de cualquier conjunto de datos con una cláusula where ODSQL sin procesar, select, order_by, limit.

Flujo típico cuando el usuario pregunta sobre algo que ningún módulo dedicado cubre (por ejemplo, vulcanología, elecciones, asistencia a bibliotecas, …):

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
})

Efecto neto: el agente puede responder preguntas respaldadas por cualquiera de los ~270 conjuntos de datos sin que nadie tenga que programar un nuevo módulo primero. Los conjuntos de datos que resultan ser populares a través de query_dataset son candidatos para ser promovidos a su propio módulo dedicado con nombres de campo seleccionados.

Instalación

npm install
npm run build
npm test
npm run dev

Claude Desktop

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

Extensión

Cada módulo reside en src/modules/ y conecta un conjunto de datos de OpenDataSoft a una o más herramientas MCP a través del ReunionClient compartido (src/client.ts). Para añadir un módulo:

1. Identifique el ID del conjunto de datos en https://data.regionreunion.com/api/explore/v2.1/catalog/datasets?limit=100.

2. Inspeccione sus campos (/catalog/datasets/<id>) para saber qué exponer.

3. Escriba un módulo siguiendo el patrón en src/modules/weather.ts o transport.ts.

4. Regístrelo en src/modules/index.ts y actualice TOOL_COUNT.

Notas de producción

• Entorno de ejecución: Node.js 18+

• Transporte: stdio

• API ascendente: https://data.regionreunion.com/api/explore/v2.1

• Autenticación: ninguna

• Idioma de los datos de origen: principalmente francés

Licencia

MIT — adaptado de lacausecrypto/mcp-new-caledonia.