korea-living-weather-index-mcp

本服务器以 MCP 形式实现，对应 기상청이 공공데이터포털을 통해 제공하는 생활기상지수 조회서비스(4.0) (LivingWthrIdxServiceV5) 服务。可以全国约 3,838 个地点（市/郡/区읍/面/洞级别）为单位、以 3 小时间隔，查询最长 7578 小时后的 紫外线指数 和 大气停滞指数 预报。

这与现有单独运营中的 safemap-uv-index-mcp（행정안안전부 생활안전지도+기상청 紫外线指数预报）是彼此独立的项目。

提供的工具

get_uv_forecast

根据站点代码（areaNo）和发布时间（time）查询紫外线指数预报。 返回从 0 小时后到 75 小时后、每 3 小时间隔的预测值。

紫外线指数等级

get_air_diffusion_forecast

根据站点代码（areaNo）和发布时间（time）查询大气停滞指数预报。 返回从 3 小时后到 78 小时后、每 3 小时间隔的预测值。

大气停滞指数等级

search_area_code

根据地区名称（시/道、市/郡/区、邑/面/洞）查询站点代码（areaNo）。

Related MCP server: korea-weather-mcp

安装与运行

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

环境变量

部署

部署到 fly.io。具体流程按照项目 bootstrap 文档执行。

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

部署后，连接 Connector 时需将 /mcp 路径加入连接地址： https://<앱이름>.fly.dev/mcp

数据来源

• 提供机构: 기상청

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

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

• 许可证: 공공누리（依据공공데이터포널 이용协议与管理）

已确认的限制（实测完成，截至 2026-08-23）

• 将 areaNo 设为空字符串时，可按照全部站点查询正常运行（并非 ERROR-10）。但响应可能很大，因此该选项未作为工具参数暴露。请使用 area_no 或 area_name 指定特定站点进行查询。

• 已确认紫外线指数响应中不包含 h78 字段（仅存在 h0~h74，说明文档示例中的 h78 应为笔误）。夜间时段的值返回空字符串，因此按缺失（None）处理。

• 大气停滞指数的实测结果确认值只会是 25/50/75/100 其中之一，但样本有限，因此在代码中仍保留安全的近似映射逻辑（37.5/62.5/87.5 边界）。

• 已确认错误响应在 dataType=JSON 请求时也以 JSON 返回（而非 XML）。XML 回退解析器保留作为安全机制。

• Rate limit（速率限制）：每分钟 3 次（按 IP）、1 小时内超过 5 次则封禁 24 小时、每日 30 次上限（多机组部署时，可能按机器数量成比例得到实际缓解）。

相关项目

• safemap-uv-index-mcp — 안전안전부 생활안전지도 + 기상청 紫外线指数预报（现有独立运营中）