korea-living-weather-index-mcp

Это MCP-сервер, реализующий 생활기상지수 조회서비스(4.0) (LivingWthrIdxServiceV5), который 기상청 предоставляет через 공공데이터포털. Он позволяет запрашивать прогнозы ультрафиолетового индекса и индекса застоя атмосферы примерно по 3 838 точкам по всей стране (в разрезе административных единиц: си/гун/гуып/мён/дон) с интервалом 3 часа и горизонтом до 7578 часов вперёд.

Это отдельный проект от существующего safemap-uv-index-mcp (прогноз ультрафиолетового индекса по 생활안전지도 от 행정안전부 в сочетании с прогнозом 기상청).

Предоставляемые инструменты

get_uv_forecast

Выполняет запрос прогноза ультрафиолетового индекса по коду точки (areaNo) и времени выпуска (time). Возвращает прогнозные значения с интервалом в 3 часа — с 0 до 75 часов вперёд.

Уровни ультрафиолетового индекса

get_air_diffusion_forecast

Выполняет запрос прогноза индекса застоя атмосферы по коду точки (areaNo) и времени выпуска (time). Возвращает прогнозные значения с интервалом в 3 часа — с 3 до 78 часов вперёд.

Уровни индекса застоя атмосферы

search_area_code

Выполняет поиск кода точки (areaNo) по названию региона (провинция/город, город/уезд/район, посёлок/волость/квартал).

Related MCP server: safemap-uv-index-mcp

Установка и запуск

pip install -r requirements.txt
cp .env.example .env  # KMA_LIVING_WEATHER_SERVICE_KEY 값 입력
python server.py

Переменные окружения

Развертывание

Развертывается на fly.io. Подробная процедура — в документе по первичной настройке проекта.

fly launch --no-deploy
fly secrets set KMA_LIVING_WEATHER_SERVICE_KEY=발급받은키
flyctl deploy

После развертывания при подключении коннектора используйте путь /mcp: https://<앱이름>.fly.dev/mcp

Источник данных

• Предоставляющий орган: 기상청

• Платформа: 공공데이터포털 (data.go.kr)

• API: 생활기상지수 조회서비스(4.0) (LivingWthrIdxServiceV5)

• Лицензия: 공공누리 (по условиям использования 공공데이터포털)

Известные ограничения (по результатам фактических проверок, по состоянию на 2026-08-23)

• Если отправить в areaNo пустую строку, запрос корректно работает как запрос по всем точкам (это не ERROR-10). Однако ответ может быть очень большим, поэтому эта опция не выведена в параметры инструмента. Указывайте конкретную точку через area_no или area_name.

• В ответе по ультрафиолетовому индексу подтверждено отсутствие поля h78 (присутствуют только h0~h75; h78 в примере из спецификации — по всей вероятности, опечатка). Ночные значения приходят как пустые строки и считаются отсутствующими (None).

• Значения индекса застоя атмосферы по данным реальных проверок оказываются ровно одним из 25/50/75/100, но выборка мала, поэтому в коде оставлена безопасная логика аппроксимирующего манипулирования с порогами 37,5/62,5/87,5.

• Подтверждено, что ошибочные ответы при запросе с dataType=JSON возвращаются в формате JSON (не XML). XML-fallback-парсер оставлен как подстраховка.

• Rate limit: 3 запроса в минуту (на IP), при превышении 5 запросов за 1 час — блокировка на 24 часа, суточный лимит — 30 запросов, при мультимашинном развертывании фактический лимит может возрасти пропорционально числу машин.

Связанные проекты

• safemap_uv_index_mcp — карта 안전지도행정안전부 + прогноз ультрафиолетового индекса от 기상청 (эксплуатируется отдельно).