mcp-reunion

MCP-сервер для открытых государственных данных острова Реюньон, работающий через stdio для Claude Desktop и других MCP-клиентов.

Что охватывает сервер

Основной источник: API OpenDataSoft Explore v2.1 по адресу data.regionreunion.com. Небольшой модуль Национальные выборы также запрашивает данные с tabular-api.data.gouv.fr для получения результатов досрочных парламентских и европейских выборов 2024 года, которые отсутствуют на региональном портале. В настоящее время доступно 99 инструментов в 22 модулях. Модуль каталога позволяет клиенту получить доступ к любому из ~270 наборов данных на data.regionreunion.com, для которых еще не созданы специализированные инструменты.

Related MCP server: mcp-brasil

Модули

• Администрирование — локальные справочники государственных органов (annuaire), реестр ассоциаций RNA, выборные должностные лица, результаты президентских и парламентских выборов 2022 года по избирательным участкам (1-й и 2-й туры парламентских выборов), уведомления о государственных закупках BOAMP, приоритетные районы QPV, имена новорожденных с 2000 года.

• Коммуна — составные инструменты, объединяющие несколько наборов данных параллельно: reunion_find_commune (нечеткий поиск для канонического кода INSEE), reunion_commune_profile (население + QPV + школы + предприятия + ДТП + музеи в одном запросе), 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) — количество соискателей работы по возрасту/полу и по коммунам.

• Окружающая среда — качество воздуха OpenAQ, тоннаж бытовых отходов, компании по эко-реновации RGE, охраняемые зоны ZNIEFF, периметры национальных парков, потребление нефтепродуктов, объекты управления водными ресурсами.

• Инфраструктура (base-permanente-des-equipements-geolocalisee-la-reunion, equipements-sportifs) — объекты BPE INSEE и национальный реестр спортивного оборудования, отфильтрованные по Реюньону.

• География (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, медицинские работники коммуны Ла-Поссесьон.

• Гостеприимство (etablissements-touristiques-lareunion-wssoubik, hebergements-classespublic, localisation-potentielle-ecolodge-lareunion) — туристические объекты, классифицированное жилье, зоны для эко-лоджей.

• Национальные выборы (tabular-api.data.gouv.fr — Министерство внутренних дел) — результаты досрочных парламентских выборов 2024 года (1-й и 2-й туры) по округам Реюньона и результаты европейских выборов 2024 года, агрегированные для департамента 974. Дополняет результаты 2022 года, представленные на региональном портале.

• Жилье (logements-et-logements-sociaux-…, couts-et-surfaces-moyens-…) — ведомственный атлас жилья и стоимость социального жилья.

• Ла-Поссесьон (donnees-essentielles-marches-publics-…, subventions-attribuees-…) — контракты на государственные закупки и гранты ассоциациям в Ла-Поссесьон.

• Социальная сфера — бенефициары CAF и суммы пособий, детские учреждения (Сен-Дени + Ла-Поссесьон).

• Телекоммуникации (sites-mobiles-5g-a-la-reunion, arcep_regions) — вышки 5G по операторам и покрытие FttH.

• Территория — сделки с недвижимостью DVF, население коммун по данным INSEE, почтовые индексы La Poste, земельные резервы potentiel foncier, разрешения на строительство жилья Sitadel.

• Туризм — семейные маршруты, каньонинг, достопримечательности и культурные объекты SIT Soubik, пешеходные маршруты, прибрежная тропа, бассейны, ежемесячная посещаемость туристами с 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 наборов данных на data.regionreunion.com, для которых еще нет специализированного инструмента, используя необработанное предложение 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/ и связывает набор данных OpenDataSoft с одним или несколькими инструментами MCP через общий ReunionClient (src/client.ts). Чтобы добавить модуль:

1. Определите ID набора данных на странице https://data.regionreunion.com/api/explore/v2.1/catalog/datasets?limit=100.

2. Изучите его поля (/catalog/datasets/<id>), чтобы понять, что именно нужно предоставить.

3. Напишите модуль, следуя шаблону в src/modules/weather.ts или transport.ts.

4. Зарегистрируйте его в src/modules/index.ts и увеличьте TOOL_COUNT.

Примечания по эксплуатации

• Среда выполнения: Node.js 18+

• Транспорт: stdio

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

• Аутентификация: отсутствует

• Язык исходных данных: преимущественно французский

Лицензия

MIT — адаптировано из lacausecrypto/mcp-new-caledonia.