mcp-reunion

mcp-reunion

La Réunionのオープンデータを利用する MCP サーバーです。Claude Desktop やその他の MCP クライアント向けに、stdio 経由で公開されます。

対応範囲

主なデータソースは、data.regionreunion.com の OpenDataSoft Explore v2.1 API です。また、地域ポータルにない2024年の前倒し実施の国政選挙および欧州議会選挙の結果を取得する、小規模な国政選挙モジュールも tabular-api.data.gouv.fr に問い合わせます。現在、26個のモジュールで108個のツールを提供しています。カタログモジュールを使うと、専用ツールがまだ用意されていない data.regionreunion.com の約270件のデータセットにもクライアントからアクセスできます。

モジュール

• 行政 — public-admin の地方カウンター（annuaire）、RNA の協会登録簿、選出議員、2022年大統領選挙・国民議会選挙の投票所別結果（国民議会選挙は第1回投票・決選投票）、BOAMP の公共調達公告、QPV の優先地区、2000年以降の赤ちゃんの名前。
• コミューン — 複数のデータセットを並行して結合する複合ツール：`reunion_find_commune`（INSEE の正規コードを特定するあいまい検索リゾルバー）、`reunion_commune_profile`（人口＋QPV＋学校＋事業所＋事故＋博物館を1回の呼び出しで取得）、`reunion_compare_communes`（2～5つのコミューンを並べて比較）、`reunion_iris_profile`（IRIS のメタデータ＋2014年の所得・貧困・格差指標）。
• 文化 — Musées de France のディレクトリ、Joconde のコレクション検索、公共図書館、祭り、年間の博物館入館者数。
• 経済 — SIRENE v3 の事業所検索、INSEE の月次消費者物価指数、FEDER 2014-2020 の受益者、コワーキングスペース、IRIS 単位の所得・貧困指標。
• 教育 — 中学校・リセの IPS、Génération 2024 ラベル、Parcoursup のプログラム、位置情報付き学校ディレクトリ、REP/REP+ の優先教育対象校、高等教育の在籍者数、研修機関/CFA。
• 雇用（demandeurs-d-emploi-…-a-la-reunion）— 年齢・性別別およびコミューン別の Pôle emploi 求職者数。
• 環境 — OpenAQ の大気質、家庭ごみのトン数、RGE のエコリノベーション事業者、ZNIEFF の保護区域、国立公園の区域、石油製品の消費量、水管理に関する注目地点。
• 施設（base-permanente-des-equipements-geolocalisee-la-reunion、equipements-sportifs）— INSEE BPE の施設と全国スポーツ施設インベントリから、レユニオンに絞り込んだデータ。
• 地理（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／サン＝ドニ地区の公式参照レイヤー。
• 医療 — CNAM の医療従事者ディレクトリ、COVID 統計、病理、FINESS、ラ・ポセッションの医療従事者。
• 遺産 — UNESCO 世界遺産の区域と、レユニオン国立公園における顕著な普遍的価値の基準 vii に関する貢献区域。
• 宿泊・観光施設（etablissements-touristiques-lareunion-wssoubik、hebergements-classespublic、localisation-potentielle-ecolodge-lareunion）— 観光施設、認定宿泊施設、エコロッジ候補区域。
• インサイト — コミューン別の公共サービスと観光に関する高レベルの複合ダッシュボード。
• 国政選挙（tabular-api.data.gouv.fr — Ministère de l'Intérieur）— レユニオンの選挙区別の2024年繰り上げ国民議会選挙結果（第1回投票・決選投票）と、県974に集計した2024年欧州議会選挙結果。地域ポータルが提供する2022年の結果を補完します。
• 近隣検索 — 座標を中心とした半径検索で、学校、Car Jaune の停留所、公式博物館を検索します。
• 住宅（logements-et-logements-sociaux-…、couts-et-surfaces-moyens-…）— 県の住宅アトラスと社会住宅の費用。
• ラ・ポセッション（donnees-essentielles-marches-publics-…、subventions-attribuees-…）— ラ・ポセッションの公共調達契約と協会への助成金。
• ルーター — reunion_find_relevant_tools。自然言語の質問から、関連する可能性の高いツール、データセット、クエリの流れを対応付ける決定論的なヘルパーです。
• 社会 — CAF の受給者と給付額、保育施設（サン＝ドニ＋ラ・ポセッション）。
• 通信（sites-mobiles-5g-a-la-reunion、arcep_regions）— 通信事業者別の5G基地局と FttH 展開状況。
• 地域 — DVF の不動産取引、INSEE のコミューン人口、La Poste の郵便番号、potentiel foncier の土地備蓄、Sitadel の住宅建築許可。
• 観光 — ファミリー向けトレイル、キャニオニングルート、SIT Soubik の名所・文化的 POI、ハイキングコース、海岸トレイル、プール、2017年以降の月次観光客数。
• 交通 — TMJA の道路交通量、機能別道路分類、Car Jaune の GTFS 停留所・路線と運行計画の参考情報、地域自転車ネットワーク、交通事故（2016-2019）、車両の車検費用、国道の日次交通量・速度制限。
• 都市計画（base-permanente-des-plu-de-la-reunion、liste-des-permis-de-constuire-…）— PLU の用途地域と非住宅建築許可（Sitadel）。
• 天気（donnees-synop-essentielles-ommpublic）— レユニオンの観測所における Météo France の SYNOP 観測データ：気温、湿度、風、気圧、降水量。観測所一覧ツールもあります。
• カタログ（メタ）— search_catalog、inspect_dataset、query_dataset。専用モジュールでカバーされていない約270のデータセットをエージェントが発見・クエリできるようにします。回避策として、生の ODSQL where 句も使用できます。
• リソース — コミューン、EPCI、IRIS、カタログ、人気のデータセットの参照データを提供する静的 MCP リソース。 data.regionreunion.com カタログには、約270のデータセットが公開されています。モジュールは必要に応じて追加できます。詳しくは下記の 拡張 をご覧ください。

データセットとツールの対応状況をモジュールごとにまとめたビューは、COVERAGE.md をご覧ください。

まだ接続されていないデータセットへのアクセス

上記の専用モジュールは、特に問い合わせの多いトピックをカバーしていますが、ポータルには全体で約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"]
    }
  }
}

使用例

プロンプトの例は examples/ にあります。

• claude-desktop.md — セットアップと最初のプロンプト
• civic-analysis.md — コミューンと調達の分析
• elections.md — 2022年および2024年の選挙分析
• tourism.md — 観光とアウトドア活動に関するプロンプト
• transport.md — 道路と公共交通機関に関するプロンプト

MCP リソース

サーバーは参照用リソースも公開しています。

• reunion://communes
• reunion://epci
• reunion://iris
• reunion://datasets/catalog
• reunion://datasets/popular

拡張

各モジュールは 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 20+
• トランスポート：stdio
• 上流 API：https://data.regionreunion.com/api/explore/v2.1
• 認証：不要
• 元データの言語：主にフランス語

メンテナンス時の確認

• npm run check:schema は、schema-expectations.json に記載された重要な上流データセットのフィールドを検証します。
• npm run docs:coverage は、COVERAGE.md を再生成します。
• 出力規約は docs/output-contracts.md に記載されています。
• リリースの自動化については docs/release.md をご覧ください。

任意のローカルテレメトリ

ツール呼び出しのテレメトリは、デフォルトで無効になっています。リモートサービスに何も送信せずに、ローカルでの使用パターンをデバッグするには、次のようにします。

MCP_REUNION_TELEMETRY=local npx -y mcp-reunion

デフォルトでは、JSONL レコードが .mcp-reunion-telemetry.jsonl に書き込まれます。MCP_REUNION_TELEMETRY_PATH でパスを変更できます。

ライセンス

MIT — lacausecrypto/mcp-new-caledonia を基に改変。