safemap-uv-index-mcp

行政安全部 生活安全地図(safemap.go.kr)が提供する紫外線指数情報照会サービス(気象庁の生活気象指数のうち紫外線指数を市郡区単位でまとめた資料)を照会するMCPサーバー。

提供データ

単一データセット構成であり、別途のDataset Registry表は不要である。

• データセット名(画面表示): 紫外線指数

• 提供機関: 気象庁 (管理部署: 気象融合サービス課)

• 提供プラットフォーム: 行政安全部 生活安全地図(safemap.go.kr)

• 元API: 紫外線指数情報照会サービス (IF_0113)

Related MCP server: korea_weather

ツール

get_uv_index

市道/市郡区基準で紫外線指数を照会する。

パラメータ

返却フィールド

既知の制約事項 (実測完了)

元仕様書がExcel/XMLサンプルではなく画面キャプチャ2枚+Javaサンプルコードのみで提供されており、実測が必要だった項目の実際の確認結果は次のとおりである (2026-08-22実測):

• returnTypeデフォルト値: returnTypeを省略しても実際にJSONが返る(案内文 "Default: JSON"が正しい)。ただし安全のため毎リクエストにreturnType=jsonを明示的に含める。

• 地域フィルタパラメータ: sidoNmなどの地域フィルタパラメータを試したが、サーバーが無視して 全データをそのまま返す — API自体の地域フィルタは非対応。このサーバーは 全国データを全体照会した後、sido/sigunguパラメータでクライアントサイド フィルタリングを実行する。

• 紫外線指数(ulvry_index): 実測結果"0", "1", "2", "7", "9"などの純粋な 数字文字列であることを確認 ("低い/普通/高い"のような等級文字列ではない)。サーバーはこれを整数に 安全変換して返す。

• 発生日時(occrrnc_dt)フォーマット: YYYYMMDDHH (時(hour)単位まで、分なし)。例: "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 preflight(OPTIONS)リクエストはカウントから除外

ライセンス

MIT License。データ自体の著作権は公共ヌリ(行政安全部 生活安全地図)の利用条件に従う。

出典

行政安全部 生活安全地図(safemap.go.kr)、気象庁(気象融合サービス課)提供「紫外線指数情報照会サービス(IF_0113)」