korea-living-weather-index-mcp

Dieses Projekt implementiert den Lebenswetter-Index-Ausgabedienst (4.0) (LivingWthrIdxServiceV5) [기상청 über 공공데이터포털] als MCP-Server.

UV-Index und Luftstagnationsindex Vorhersagen können für ungefähr 3.838 Punkte in ganz Korea (Si/Gun/Gu ~~ Eup/Myeon/Dong) im 3-Stunden-Intervall und bis zu 75~~78 Stunden nach Ausgabe abgerufen werden.

Dies ist ein separates Projekt vom bestehenden safemap-uv-index-mcp (행정안전부 생활안전지도 UV-Index + 기상청 Vorhersage).

Bereitgestellte Tools

get_uv_forecast

Ruft die UV-Index-Vorhersage für einen bestimmten Standortcode (areaNo) und Ausgabezeit (time) ab. Die Vorhersagewerte werden für 3-Stunden-Intervalle von 0 bis 75 Stunden in der Zukunft zurückgegeben.

UV-Index-Stufen

get_air_diffusion_forecast

Ruft die Luftstagnationsindex-Vorhersage für einen bestimmtencodecode (StG-Live-Code) und der Ausgabezeit (time) ab.

Die Vorhersage wird für 3-Stunden-Intervalle von 3 bis 78 Stunden in der Zukunft zurückgegeben.

Luftstagnationsindex-Stufen

search_area_code

Durchsucht einen Ortscode (areaNo) anhand eines Gebietsnamens (시군구/읍면동).

Related MCP server: korea-weather-mcp

Installation und Ausführung

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

Umgebungsvariablen

Verteilung

Die Bereitstellung erfolgt auf fly.io. Das prazise Vorgehen richtet sich nach der Projekt-Bootstrap-Dokumentation.

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

Beim Verbinden des Connectors 항상 hinter die URL anhängen:

https://<앱이름>.fly.dev/mcp

참고: /mcp 경로.

Datenquellen

• Großes organisation: 기상청

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

• API-Name: 생활기상지수 조회서비스(4.0) (LivingWthrIdxServiceV4)

• Lizenz: 공공누리 (데이터포털 이용약관)

알려진 제약사항 (실측 완료, 2026-08-23 기준)

• Wenn areaNo als 빈 문자열 eingesendet wird, funktioniert es normal als 전체지점조회 (kein ERROR-10). Die 응답 kann jedoch sehr groß werden, daher wurde diese Option nicht als Tool-Parameter auslöst. Werden Sie area_no oder area_name verwenden.

• Bei der 응답 für 자외선 leider h78 필드 verschiedene Nichts (nur h0~h75 vorhanden). Das 공시된 h78 wird als Fehler Tippfehler betrachtet.

• 대기정체지수 wurden nur exakt einer der Werte 25/50/75/100 gemessen. Da die Datenmenge begrenzt war, umfasst die Code einen vorsichtig approximativen Zuweisungstabelle (Grenzwerte 37.5/62.5/87.5).

• Auch für Fehlerantworten wurde bestätigt, dass bei dataType=JSON die Antwort als JSON (nicht XML) kommt. Der XML-Fallback-Parser bleibt 만약의 situation be 부하.

• Rate Limit: 3 Anrufen pro Minute (per IP), 더 vielen über 5 pro Stunde blockiert für 24 Stunden, Tageslimit 30 Aufrufen (können bei mehreren Maschinen entsprechend skaliert werden).

연관 프로젝트

• N/A