mcp-reunion

レユニオン島の公開オープンデータのためのMCPサーバー。Claude Desktopやその他のMCPクライアント向けに stdio 経由で公開されています。

対象範囲

主なソースは data.regionreunion.com のOpenDataSoft Explore v2.1 APIです。小規模な国政選挙モジュールでは、地域ポータルで提供されていない2024年の繰り上げ立法議会選挙および欧州議会選挙の結果を取得するために tabular-api.data.gouv.fr もクエリします。現在、22モジュールにわたる99のツールが利用可能です。カタログモジュールを使用すると、クライアントは data.regionreunion.com にある約270のデータセットのうち、まだ専用ツールに接続されていないものにアクセスできます。

Related MCP server: mcp-brasil

モジュール

• Administration — 公共行政のローカルカウンター（ディレクトリ）、RNA協会登録簿、選出公職者、2022年大統領選および立法議会選挙結果（投票所別、立法議会は第1回・第2回）、BOAMP公共調達通知、QPV優先地区、2000年以降の赤ちゃんの名前。

• Commune — 複数のデータセットを並列で結合する複合ツール：reunion_find_commune（正規のINSEEコードへの曖昧検索）、reunion_commune_profile（人口、QPV、学校、企業、事故、博物館を1回の呼び出しで取得）、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) — 年齢/性別および自治体別の求職者数。

• 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、ラ・ポセシオンの医療専門家。

• 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-…) — ラ・ポセシオンの公共調達契約および協会助成金。

• Social — CAF受益者および給付額、保育施設（サン＝ドニ + ラ・ポセシオン）。

• 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のデータセットがあります。すべてのニッチな質問に対して新しいモジュールを作成する代わりに、カタログモジュールはMCPクライアントに、ポータル全体へのエスケープハッチとして機能する3つの汎用ツールを提供します：

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データセットを1つ以上の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 からの適応。