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) — 공공 행정 지역 카운터(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) — 연령/성별 및 코뮌별 구직자 수.

• 환경(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 의료 전문가 디렉토리, 코로나19 통계, 병리학, 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-…) — 라 포세시옹의 공공 조달 계약 및 협회 보조금.

• 사회(Social) — CAF 수혜자 및 급여액, 보육 시설(생드니 + 포세시옹).

• 통신(Telecom) (sites-mobiles-5g-a-la-reunion, arcep_regions) — 통신사별 5G 기지국 및 FttH 배포 범위.

• 영토(Territory) — DVF 부동산 거래, INSEE 코뮌 인구, 라 포스트 우편번호, 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 클라이언트에 전체 포털로 향하는 탈출구 역할을 하는 세 가지 일반 도구를 제공합니다:

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에서 수정됨.