mcp-reunion

MCP-Server für öffentliche Open Data von La Réunion, bereitgestellt über stdio für Claude Desktop und andere MCP-Clients.

Abdeckung

Primärquelle: die OpenDataSoft Explore v2.1 API unter data.regionreunion.com. Ein kleines Modul für nationale Wahlen fragt zusätzlich tabular-api.data.gouv.fr für die vorgezogenen Parlamentswahlen 2024 sowie die Europawahlergebnisse ab, die das Regionalportal nicht enthält. Derzeit 99 Tools in 22 Modulen. Ein Katalog-Modul ermöglicht es dem Client, auf jeden der ca. 270 Datensätze unter data.regionreunion.com zuzugreifen, die noch nicht mit einem dedizierten Tool verknüpft sind.

Related MCP server: mcp-brasil

Module

• Verwaltung — lokale öffentliche Verwaltungszähler (annuaire), RNA-Vereinsregister, gewählte Amtsträger, Ergebnisse der Präsidentschafts- und Parlamentswahlen 2022 pro Wahllokal (1. & 2. Wahlgang für Parlamentswahlen), BOAMP-Bekanntmachungen für öffentliche Aufträge, QPV-Prioritätsviertel, Vornamen seit 2000.

• Gemeinde — zusammengesetzte Tools, die mehrere Datensätze parallel verknüpfen: reunion_find_commune (Fuzzy-Resolver zum kanonischen INSEE-Code), reunion_commune_profile (Bevölkerung + QPV + Schulen + Unternehmen + Unfälle + Museen in einem Aufruf), reunion_compare_communes (direkter Vergleich von 2-5 Gemeinden), reunion_iris_profile (IRIS-Metadaten + Indikatoren zu Einkommen/Armut/Ungleichheit von 2014).

• Kultur — Verzeichnis der Musées de France, Suche in der Joconde-Sammlung, öffentliche Bibliotheken, Festivals, jährliche Museumsbesucherzahlen.

• Wirtschaft — SIRENE v3-Unternehmenssuche, monatlicher VPI des INSEE, Begünstigte des FEDER 2014-2020, Coworking-Spaces, Indikatoren zu Einkommen/Armut auf IRIS-Ebene.

• Bildung — IPS für Mittelschulen & Gymnasien, Label Génération 2024, Parcoursup-Programme, geolokalisiertes Schulverzeichnis, REP/REP+-Schulen mit Prioritätsbildung, Einschreibungen an Hochschulen, Ausbildungseinrichtungen/CFA.

• Beschäftigung (demandeurs-d-emploi-…-a-la-reunion) — Anzahl der Arbeitssuchenden bei Pôle emploi nach Alter/Geschlecht und Gemeinde.

• Umwelt — OpenAQ-Luftqualität, Tonnage von Haushaltsabfällen, RGE-Unternehmen für Öko-Renovierung, ZNIEFF-Schutzgebiete, Umrisse des Nationalparks, Verbrauch von Erdölprodukten, Points of Interest für die Wasserwirtschaft.

• Einrichtungen (base-permanente-des-equipements-geolocalisee-la-reunion, equipements-sportifs) — INSEE BPE-Einrichtungen und das nationale Inventar für Sportausrüstung, gefiltert für La Réunion.

• Geografie (ban-lareunion, bal-la-possession, communes-millesime-france, cantons-millesime-france, intercommunalites-millesime-france, iris-millesime-france, les-20-quartiers-villesaintdenis) — BAN/BAL-Adressen und die offiziellen Referenzebenen für Gemeinden / Kantone / EPCI / IRIS / Stadtviertel von Saint-Denis.

• Gesundheit — Verzeichnis der Gesundheitsberufe der CNAM, COVID-Statistiken, Pathologien, FINESS, Gesundheitsberufe in La Possession.

• Gastgewerbe (etablissements-touristiques-lareunion-wssoubik, hebergements-classespublic, localisation-potentielle-ecolodge-lareunion) — Tourismusbetriebe, klassifizierte Unterkünfte, Zonen für Ecolodges.

• Nationale Wahlen (tabular-api.data.gouv.fr — Innenministerium) — Ergebnisse der vorgezogenen Parlamentswahlen 2024 (1. & 2. Wahlgang) pro Wahlkreis auf La Réunion sowie die Europawahlergebnisse 2024, aggregiert für das Département 974. Ergänzt die Ergebnisse von 2022, die im Regionalportal enthalten sind.

• Wohnungsbau (logements-et-logements-sociaux-…, couts-et-surfaces-moyens-…) — Departementaler Wohnungsatlas und Kosten für Sozialwohnungen.

• Possession (donnees-essentielles-marches-publics-…, subventions-attribuees-…) — Öffentliche Aufträge und Vereinszuschüsse der Gemeinde La Possession.

• Soziales — CAF-Begünstigte und Leistungsbeträge, Kinderbetreuungseinrichtungen (Saint-Denis + Possession).

• Telekommunikation (sites-mobiles-5g-a-la-reunion, arcep_regions) — 5G-Mobilfunkstandorte pro Betreiber und FttH-Ausbauabdeckung.

• Territorium — DVF-Immobilientransaktionen, INSEE-Gemeindebevölkerung, Postleitzahlen von La Poste, potentiel foncier (Flächenreserven), Sitadel-Baugenehmigungen für Wohngebäude.

• Tourismus — Familienwanderwege, Canyoning-Routen, SIT Soubik-Sehenswürdigkeiten & kulturelle POIs, Wanderwege, Küstenpfad, Schwimmbäder, monatliche Tourismusfrequenz seit 2017.

• Verkehr — TMJA-Straßenverkehr, funktionale Straßenklassifizierung, Car Jaune GTFS-Haltestellen/Routen, regionales Radwegenetz, Verkehrsunfälle (2016-2019), Preise für technische Fahrzeugüberprüfungen, täglicher Verkehrsfluss & Geschwindigkeitsbegrenzungen auf Nationalstraßen.

• Stadtplanung (base-permanente-des-plu-de-la-reunion, liste-des-permis-de-constuire-…) — PLU-Zonierung und Baugenehmigungen für Nichtwohngebäude (Sitadel).

• Wetter (donnees-synop-essentielles-ommpublic) — Météo France SYNOP-Beobachtungen für Stationen auf La Réunion: Temperatur, Luftfeuchtigkeit, Wind, Druck, Niederschlag; plus ein Tool zur Auflistung der Stationen.

• Katalog (Meta) — search_catalog, inspect_dataset, query_dataset. Ermöglicht dem Agenten, jeden der ca. 270 Datensätze zu finden und abzufragen, die noch nicht durch ein dediziertes Modul abgedeckt sind, mit einer rohen ODSQL-where-Klausel als Ausweg.

Der Katalog data.regionreunion.com umfasst ca. 270 Datensätze. Weitere Module können schrittweise hinzugefügt werden — siehe Erweiterung unten.

Zugriff auf Datensätze, die noch nicht verknüpft sind

Die oben genannten dedizierten Module decken die am häufigsten nachgefragten Themen ab, aber das Portal enthält insgesamt ca. 270 Datensätze. Anstatt für jede spezifische Frage ein neues Modul zu schreiben, bietet das Katalog-Modul dem MCP-Client drei generische Tools, die zusammen als Schnittstelle zum gesamten Portal fungieren:

1. reunion_search_catalog — Suche nach Schlüsselwörtern / Themen / Herausgebern über alle Datensätze hinweg. Gibt Datensatz-IDs, Titel, Beschreibungen und Datensatzanzahlen zurück.

2. reunion_inspect_dataset — Gibt bei Angabe einer Datensatz-ID das vollständige Schema (Feldnamen + Typen) zurück, damit der Agent weiß, wonach er filtern kann.

3. reunion_query_dataset — Ruft Datensätze aus einem beliebigen Datensatz mit einer rohen ODSQL-where-Klausel, select, order_by, limit ab.

Typischer Ablauf, wenn der Benutzer nach etwas fragt, das kein dediziertes Modul abdeckt (z. B. Vulkanologie, Wahlen, Bibliotheksbesuche, …):

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

Nettoeffekt: Der Agent kann Fragen beantworten, die auf jedem der ca. 270 Datensätze basieren, ohne dass jemand zuerst ein neues Modul programmieren muss. Datensätze, die sich über query_dataset als beliebt erweisen, sind Kandidaten für die Aufnahme in ein eigenes dediziertes Modul mit kuratierten Feldnamen.

Installation

npm install
npm run build
npm test
npm run dev

Claude Desktop

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

Erweiterung

Jedes Modul befindet sich in src/modules/ und verknüpft einen OpenDataSoft-Datensatz über den gemeinsamen ReunionClient (src/client.ts) mit einem oder mehreren MCP-Tools. So fügen Sie ein Modul hinzu:

1. Identifizieren Sie die Datensatz-ID unter https://data.regionreunion.com/api/explore/v2.1/catalog/datasets?limit=100.

2. Überprüfen Sie die Felder (/catalog/datasets/<id>), um zu wissen, was offengelegt werden soll.

3. Schreiben Sie ein Modul nach dem Muster in src/modules/weather.ts oder transport.ts.

4. Registrieren Sie es in src/modules/index.ts und erhöhen Sie TOOL_COUNT.

Produktionshinweise

• Laufzeit: Node.js 18+

• Transport: stdio

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

• Authentifizierung: keine

• Sprache der Quelldaten: hauptsächlich Französisch

Lizenz

MIT — adaptiert von lacausecrypto/mcp-new-caledonia.