Python MCP Korea Wetterdienst

Korea Wetter MCP Server

Dieser MCP-Server (Multi-Platform Communication Protocol) bietet Zugriff auf die APIs der Korea Meteorological Administration (KMA), sodass KI-Agenten Wettervorhersageinformationen für Standorte in Südkorea abrufen können.

Überblick

Abrufen präziser Gitterkoordinaten für koreanische Verwaltungsregionen
Erhalten Sie detaillierte kurzfristige Wettervorhersagen für jeden Ort in Korea
Unterstützung für alle koreanischen Verwaltungseinheiten (Stadt, Bezirk, Stadtteil)
Strukturierte Textantworten, optimiert für die LLM-Nutzung
Umfassende Wetterdaten einschließlich Temperatur, Niederschlag, Himmelszustand, Luftfeuchtigkeit, Windrichtung und Windgeschwindigkeit

Aufstellen

Voraussetzungen

Python 3.12+
API-Anmeldeinformationen der Korea Meteorological Administration
Sie können die API-Anmeldeinformationen erhalten, indem Sie sich beim öffentlichen Datenportal anmelden und Zugriff auf die API „조회서비스“ anfordern.

Installation

Klonen Sie das Repository:

git clone https://github.com/jikime/py-mcp-ko-weather.git
cd py-mcp-ko-weather

UV-Anlage

curl -LsSf https://astral.sh/uv/install.sh | sh

Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten:

uv venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txt

Erstellen Sie eine .env Datei mit Ihren KMA-API-Anmeldeinformationen:

cp env.example .env
vi .env

KO_WEATHER_API_KEY=your_api_key_here

Migrieren Sie die Gitterkoordinatendaten von Excel nach SQLite:

uv run src/migrate.py

Verwenden von Docker

Erstellen Sie das Docker-Image:

docker build -t py-mcp-ko-weather .

Führen Sie den Container aus:

docker run py-mcp-ko-weather

Lokale Verwendung

Führen Sie den Server aus:

mcp run src/server.py

Führen Sie den MCP Inspector aus

mcp dev server.py

MCP-Einstellungen konfigurieren

Fügen Sie die Serverkonfiguration zu Ihrer MCP-Einstellungsdatei hinzu:

Claude Desktop-App

So installieren Sie es automatisch über Smithery :

npx -y @smithery/cli install @jikime/py-mcp-ko-weather --client claude

Zur manuellen Installation öffnen Sie ~/Library/Application Support/Claude/claude_desktop_config.json

Fügen Sie dies zum mcpServers -Objekt hinzu:

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-ko-weather",
        "run",
        "src/server.py"
      ]
    }
  }
}

Cursor-IDE

Öffnen Sie ~/.cursor/mcp.json

Fügen Sie dies zum mcpServers -Objekt hinzu:

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-ko-weather",
        "run",
        "src/server.py"
      ]
    }
  }
}

für Docker

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-ko-weather"
      ]
    }
  }
}

Verwendung mit Claude

Nach der Konfiguration können Sie Claude Fragen stellen wie:

„서울특별third 서초구 양재1동의 날씨는?“
„부산보를 알려줘“
„분당구의 현재 기온은?“

API-Referenz

Werkzeuge

Rasterstandort abrufen

get_grid_location(city: str, gu: str, dong: str) -> dict

Ruft die von der API der Korea Meteorological Administration verwendeten Gitterkoordinaten (nx, ny) für den angegebenen Standort ab. Dieses Tool durchsucht die Datenbank nach den genauen Koordinaten basierend auf Informationen zu Stadt/Provinz, Bezirk/Landkreis und Stadtteil/Ort.

Prognose abrufen

get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str

Ruft die API für Ultrakurzzeitprognosen der KMA auf, um Wettervorhersageinformationen für einen bestimmten Ort bereitzustellen. Gibt umfassende Wetterdaten zurück, einschließlich Temperatur, Niederschlag, Himmelszustand, Luftfeuchtigkeit, Windrichtung und Windgeschwindigkeit.

Ressourcen

Wetteranweisungen

GET weather://instructions

Bietet eine ausführliche Dokumentation zur Verwendung des Korea Weather MCP-Servers, einschließlich Tool-Workflows und Antwortformaten.

Eingabeaufforderungen

Wetterabfrage

Der Server enthält eine strukturierte Eingabeaufforderungsvorlage zur Führung von Gesprächen über Wetterabfragen, die eine effiziente Informationsbeschaffung und eine klare Darstellung der Prognosedaten gewährleistet.

Antwortformat

Die Antworten auf die Wettervorhersage werden in einem strukturierten Textformat bereitgestellt, das für die LLM-Verarbeitung optimiert ist:

Weather forecast for 서울특별시 서초구 양재1동 (coordinates: nx=61, ny=125)
Date: 2025-05-01
Time: 15:00

Current conditions:
Temperature: 22.3°C
Sky condition: Mostly clear
Precipitation type: None
Precipitation probability: 0%
Humidity: 45%
Wind direction: Northwest
Wind speed: 2.3 m/s

Hourly forecast:
16:00 - Temperature: 21.8°C, Sky: Clear, Precipitation: None
17:00 - Temperature: 20.5°C, Sky: Clear, Precipitation: None
18:00 - Temperature: 19.2°C, Sky: Clear, Precipitation: None
...

Danksagung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Python MCP Korea Weather Service

Integrations