safemap-uv-index-mcp

从行政安全部生活安全地图（safemap.go.kr）提供的紫外线指数信息查询服务（气象厅生活气象指数中按市郡区整理的紫外线指数资料）进行查询的MCP服务器。

提供数据

由单一数据集构成，无需单独的Dataset Registry表格。

• 数据集名称（画面显示）：紫外线指数

• 提供机构：气象厅（管理部门：气象融合服务科）

• 提供平台：行政安全部生活安全地图（safemap.go.kr）

• 原始API：紫外线指数信息查询服务（IF_0113）

Related MCP server: korea_weather

工具

get_uv_index

按市道/市郡区标准查询紫外线指数。

参数

返回字段

已知限制事项（实测完成）

原始规格书仅以2张画面截图+Java示例代码提供（而非Excel/XML示例），因此 需要实测的项目实际确认结果如下（2026-08-22实测）：

• returnType默认值：省略returnType时实际也会返回JSON（提示文字 "Default: JSON"正确）。但为安全起见，每次请求均显式包含returnType=json。

• 地区过滤参数：尝试了sidoNm等地区过滤参数，但服务器忽略并 原样返回全部数据——API本身不支持地区过滤。本服务器在 全量查询全国数据后，通过sido/sigungu参数执行客户端侧过滤。

• 紫外线指数（ulvry_index）：实测确认为"0"、"1"、"2"、"7"、"9"等纯 数字字符串（非"低/普通/高"等等级字符串）。服务器将其安全转换为整数后返回。

• 发生日期时间（occrrnc_dt）格式：YYYYMMDDHH（精确到小时，无分钟）。例如： "2026072106"。

• totalCount / 全国市郡区数量：以numOfRows=1000, pageNo=1调用时totalCount=269， 实际返回条数也为269条，两者一致。包含全部17个市道，各市道均包含代表 "市郡区整体"的项目（signgu_nm=""）和个别市郡区项目。

• 错误代码：正常响应为resultCode="00"、resultMsg="NORMAL_SERVICE"。使用错误的 服务密钥调用时返回resultCode="30"、resultMsg="SERVICE_KEY_IS_NOT_REGISTERED_ERROR" （HTTP状态码确认为500）。

• 邑面洞名称（emd_nm）：在实测范围内始终确认为空字符串。

• 端点：调用http://safemap.go.kr/openapi2/IF_0113时会重定向至https://www.safemap.go.kr/... （自动https转换，通过httpx follow_redirects=True处理）。

安装与运行

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

环境变量

部署（fly.io）

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

部署后连接Claude.ai连接器时，必须附加/mcp路径：

https://safemap-uv-index-mcp.fly.dev/mcp

Rate Limit

由于是无API密钥认证、仅凭URL即可连接连接器的公开服务器，因此适用基于IP的 滑动窗口方式rate limit：

• 60秒内超过30次时返回429（优先使用Fly-Client-IP头，若无则使用X-Forwarded-For第一个值）

• CORS预检（OPTIONS）请求不计入次数

许可证

MIT License。数据本身的版权遵循公共누리（行政安全部生活安全地图）使用条件。

来源

行政安全部生活安全地图（safemap.go.kr），气象厅（气象融合服务科）提供 「紫外线指数信息查询服务（IF_0113）」