safemap-uv-index-mcp

An MCP server that queries the UV Index Information Inquiry Service (ultraviolet index data from the Korea Meteorological Administration's living weather index, organized by city/county/district) provided by the Ministry of the Interior and Safety's Life Safety Map (safemap.go.kr).

Provided Data

Single dataset structure, so no separate Dataset Registry table is needed.

• Dataset name (display): UV Index

• Provider: Korea Meteorological Administration (Managing department: Meteorological Convergence Service Division)

• Platform: Ministry of the Interior and Safety Life Safety Map (safemap.go.kr)

• Original API: UV Index Information Inquiry Service (IF_0113)

Related MCP server: korea_weather

Tools

get_uv_index

Queries the UV index by province/city/county/district.

Parameters

Return Fields

Known Limitations (Measurement Complete)

The original specification was provided only as 2 screen captures + Java sample code rather than Excel/XML samples, so the actual verification results for items requiring measurement are as follows (measured 2026-08-22):

• returnType default value: Even when returnType is omitted, JSON is actually returned (the notice "Default: JSON" is correct). However, to be safe, returnType=json is explicitly included in every request.

• Region filter parameters: Tried region filter parameters such as sidoNm, but the server ignores them and returns all data as-is — the API does not support built-in region filtering. This server fetches all nationwide data and then performs client-side filtering with the sido/sigungu parameters.

• UV index (ulvry_index): Confirmed in actual measurements to be pure numeric strings such as "0", "1", "2", "7", "9" (not grade strings like "Low/Moderate/High"). The server safely converts these to integers before returning.

• Occurrence date/time (occrrnc_dt) format: YYYYMMDDHH (down to the hour, no minutes). Example: "2026072106".

• totalCount / nationwide city/county/district count: When called with numOfRows=1000, pageNo=1, totalCount=269 and the actual number of returned items is also 269, matching. All 17 provinces are included, with each province having an item representing the "entire province" (signgu_nm="") along with individual city/county/district items.

• Error codes: Normal responses have resultCode="00", resultMsg="NORMAL_SERVICE". When called with an invalid service key, resultCode="30", resultMsg="SERVICE_KEY_IS_NOT_REGISTERED_ERROR" (HTTP status code confirmed as 500).

• Town/neighborhood name (emd_nm): Confirmed to always be an empty string within the measured range.

• Endpoint: Calling http://safemap.go.kr/openapi2/IF_0113 redirects to https://www.safemap.go.kr/... (automatic HTTPS conversion, handled with httpx follow_redirects=True).

Installation and Execution

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

Environment Variables

Deployment (fly.io)

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

When connecting via the Claude.ai connector after deployment, be sure to append the /mcp path:

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

Rate Limit

Since this is a public server that can be connected via URL alone without API key authentication, an IP-based sliding window rate limit is applied:

• More than 30 requests within 60 seconds returns 429 (Fly-Client-IP header takes priority; if absent, the first value of X-Forwarded-For is used)

• CORS preflight (OPTIONS) requests are excluded from the count

License

MIT License. The copyright of the data itself follows the usage terms of the Public Data license (Ministry of the Interior and Safety Life Safety Map).

Source

Provided by the Ministry of the Interior and Safety Life Safety Map (safemap.go.kr), Korea Meteorological Administration (Meteorological Convergence Service Division) 「UV Index Information Inquiry Service (IF_0113)」