korea-living-weather-index-mcp

Servidor que implementa en MCP el servicio 생활기상지수 조회서비스(4.0) (LivingWthrIdxServiceV5) ofrecido por 기상청 a través de 공공데이터포털. Permite consultar las previsiones del índice UV y del índice de estancamiento atmosférico en unos 3.838 puntos de todo el país (desde unidades 시/군/구 hasta 읍/면/동), con intervalos de 3 horas y hasta 75 a 78 horas de antelación.

Es un proyecto independiente del ya existente safemap-uv-index-mcp (índice UV de 생활안전지도 de 행정안전부 + previsión de 기상청).

Herramientas disponibles

get_uv_forecast

Consulta la previsión del índice UV según el código de punto (areaNo) y la hora de emisión (time). Devuelve los valores previstos en intervalos de 3 horas, desde la hora 0 hasta pasadas 75 horas.

Niveles del índice UV

get_air_diffusion_forecast

Consulta la previsión del índice de estancamiento atmosférico según el código de punto (areaNo) y la hora de emisión (time). Devuelve los valores previstos en intervalos de 3 horas, desde pasadas 3 horas hasta pasadas 78 horas.

Niveles del índice de estancamiento atmosférico

search_area_code

Busca el código de punto (areaNo) por el nombre de la región (시/도, 시/군/구, 읍/면/동).

Related MCP server: safemap-uv-index-mcp

Instalación y ejecución

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

Variables de entorno

Despliegue

Se despliega en fly.io. El procedimiento detallado se realizará según el documento de bootstrap del proyecto.

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

Tras el despliegue, para conectar el conector, añadir la ruta /mcp a la URL: https://<앱이름>.fly.dev/mcp

Origen de los datos

• Organismo proveedor: 기상청

• Plataforma: 공공데이터포털 (data.go.kr)

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

• Licencia: 공공누리 (según términos de uso de 공공데이터포털)

Limitaciones conocidas (verificación real realizada, a fecha de 2026-08-23)

• Enviar areaNo como cadena vacía funciona correctamente como consulta a todas las estaciones (no es un ERROR-10). Sin embargo, la respuesta puede ser muy grande, por lo que no se ha expuesto como parámetro de herramienta. Consulta un punto específico mediante area_no o area_name.

• En la respuesta de índice UV se ha confirmado que el campo h78 no h78 está incluido (solo existen h0~h75; se considera un error tipográfico en el ejemplo de la especificación). Los valores del turno de noche llegan como cadena vacía y se tratan como valor faltante (None).

• Los valores del índice de estancamiento atmosférico han sido confirmados solo como 25/50/75/100 en las pruebas reales, pero como la muestra es limitada, en el código se mantiene el mapeo con lógica aproximada por seguridad (límites 37.5/62.5/87.5).

• También se ha confirmado que las respuestas de error llegan en JSON cuando se solicita con dataType=JSON, no en XML. El parser XML de respaldo se conserva como medida de seguro.

• Límite de llamadas: 3 por minuto (por IP), 24 horas de bloqueo si se superan 5 llamadas en 1 hora, máximo 30 al día (en despliegues multimaquina puede verse en la práctica reducido de forma proporcional al número de máquinas).

Proyectos relacionados

• safemap-uv-index-mcp — índice 자외선지수 del mapa de seguridad de vida de 행정안전부 + pronóstico de 기상청 (en funcionamiento por separado)