safemap-uv-index-mcp

MCP-Server zum Abrufen des UV-Index-Informationsdienstes (vom Ministerium für öffentliche Verwaltung und Sicherheit bereitgestellte Lebenssicherheitskarte safemap.go.kr; Daten des Wetterdienstes zu Lebenswetterindizes, aufbereitet auf Stadt-/Landkreisebene).

Bereitgestellte Daten

Besteht aus einem einzelnen Datensatz; eine separate Dataset-Registry-Tabelle ist nicht erforderlich.

• Datensatzname (Bildschirmanzeige): UV-Index

• Bereitstellende Behörde: Korea Meteorological Administration (zuständige Abteilung: Abteilung für Wetterkonvergenzdienste)

• Bereitstellungsplattform: Lebenssicherheitskarte des Ministeriums für öffentliche Verwaltung und Sicherheit (safemap.go.kr)

• Ursprüngliche API: UV-Index-Informationsabfragedienst (IF_0113)

Related MCP server: korea_weather

Tools

get_uv_index

Ruft den UV-Index basierend auf Provinz/Stadt-Landkreis ab.

Parameter

Rückgabefelder

Bekannte Einschränkungen (Messung abgeschlossen)

Da die ursprüngliche Spezifikation nicht als Excel-/XML-Beispiel, sondern nur als 2 Bildschirmaufnahmen + Java-Beispielcode bereitgestellt wurde, sind die tatsächlichen Überprüfungsergebnisse der messungspflichtigen Punkte wie folgt (Messung vom 22.08.2026):

• returnType-Standardwert: Auch wenn returnType weggelassen wird, wird tatsächlich JSON zurückgegeben (der Hinweistext "Default: JSON" ist korrekt). Zur Sicherheit wird jedoch bei jeder Anfrage explizit returnType=json mitgesendet.

• Regionsfilter-Parameter: Regionsfilter-Parameter wie sidoNm wurden getestet, aber der Server ignoriert sie und gibt alle Daten unverändert zurück — die API selbst unterstützt keinen Regionsfilter. Dieser Server ruft zunächst alle landesweiten Daten ab und führt dann die clientseitige Filterung über die Parameter sido/sigungu durch.

• UV-Index (ulvry_index): Bei Messergebnissen als reine Zahlenzeichenfolgen wie "0", "1", "2", "7", "9" bestätigt (keine Bewertungszeichenfolgen wie "niedrig/mittel/hoch"). Der Server wandelt diese sicher in Ganzzahlen um und gibt sie zurück.

• Format des Ereigniszeitpunkts (occrrnc_dt): YYYYMMDDHH (bis zur Stunde, ohne Minuten). Beispiel: "2026072106".

• totalCount / Anzahl der Stadt-/Landkreise landesweit: Bei Aufruf mit numOfRows=1000, pageNo=1 ergibt sich totalCount=269, und auch die tatsächlich zurückgegebenen Einträge betragen 269 und stimmen überein. Alle 17 Provinzen sind enthalten, wobei für jede Provinz sowohl der Eintrag, der die "gesamte Provinz" repräsentiert (signgu_nm=""), als auch die einzelnen Stadt-/Landkreiseinträge kommen.

• Fehlercodes: Bei normaler Antwort resultCode="00", resultMsg="NORMAL_SERVICE". Bei Aufruf mit ungültigem Dienstschlüssel resultCode="30", resultMsg="SERVICE_KEY_IS_NOT_REGISTERED_ERROR" (HTTP-Statuscode wurde als 500 bestätigt).

• Stadtteil-/Dorfname (emd_nm): Im Messumfang immer als leere Zeichenkette bestätigt.

• Endpunkt: Beim Aufruf von http://safemap.go.kr/openapi2/IF_0113 erfolgt eine Weiterleitung zu https://www.safemap.go.kr/... (automatische HTTPS-Umleitung, verarbeitet mit httpx follow_redirects=True).

Installation und Ausführung

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

Umgebungsvariablen

Bereitstellung (fly.io)

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

Beim Verbinden mit dem Claude.ai-Connector nach der Bereitstellung muss unbedingt der Pfad /mcp angehängt werden:

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

Rate Limit

Da es sich um einen öffentlichen Server handelt, der ohne API-Key-Authentifizierung nur über die URL verbunden werden kann, wird ein IP-basiertes Rate Limit im gleitenden Fensterverfahren angewendet:

• Bei mehr als 30 Anfragen innerhalb von 60 Sekunden wird 429 zurückgegeben (Header Fly-Client-IP hat Priorität, andernfalls wird der erste Wert von X-Forwarded-For verwendet)

• CORS-Preflight-Anfragen (OPTIONS) sind von der Zählung ausgenommen

Lizenz

MIT-Lizenz. Das Urheberrecht an den Daten selbst unterliegt den Nutzungsbedingungen von KOGL (Lebenssicherheitskarte des Ministeriums für öffentliche Verwaltung und Sicherheit).

Quelle

Bereitgestellt von der Lebenssicherheitskarte des Ministeriums für öffentliche Verwaltung und Sicherheit (safemap.go.kr) und der Korea Meteorological Administration (Abteilung für Wetterkonvergenzdienste): „UV-Index-Informationsabfragedienst (IF_0113)"