Korean Weather

🚀 韓国天気 MCP サーバー

このサーバーは多プラットフォーム通信プロトコル（MCP）を用いて構築された韓国の天気サーバーです。KMA（韓国気象庁）の公開データインターフェースを通じて、リアルタイムの天気と超短期天気予報を照会することができます。

✨ 主な機能

• グリッド座標(nx, ny)を使用して天気データを取得することができます。
• 温度、降水タイプ、降水量、天空の状況、湿度、風向、風速など、詳細な天気状況を提供します。
• 市、区、町レベルでの天気情報の照会をサポートしています。
• 理解しやすい天気予報形式を自動生成します。

📦 インストール

環境要件

• Python 3.7以上のバージョン
• 必要なPython依存パッケージがインストールされていること（例：requests）

リポジトリのクローン

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

依存パッケージのインストール

pip install -r requirements.txt

🚀 クイックスタート

1. 環境変数を設定し、KMA APIのアクセスキーを指定します。
2. メイン関数でサーバーを起動します。

from server import start_server

if __name__ == "__main__":
    start_server()

📚 ドキュメント

コアAPIツール

グリッド座標の取得

def get_grid_location(city: str, gu: str, dong: str) -> dict:
    """
    指定された行政区域情報を通じて、対応する気象庁のグリッド座標を取得します。
    
    Args:
        city (str): 市/省の名称
        gu (str): 区/県の名称
        dong (str): 町/鎮の名称
        
    Returns:
        dict: nxとny座標を含む辞書。見つからない場合は空の辞書を返します。
    """

天気予報の取得

def get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str:
    """
    KMAの超短期天気予報APIを呼び出します。
    
    Args:
        city (str): 市/省の名称
        gu (str): 区/県の名称
        dong (str): 町/鎮の名称
        nx (int): 横座標
        ny (int): 縦座標
        
    Returns:
        str: 天気予報の構造化されたテキスト情報
    """

応答形式

天気予報は構造化されたテキスト形式で返され、LLMでの処理が容易です。

天気予報为： 서울특별시 서초구 양재1동 (坐标: nx=61, ny=125)
日期: 2025-05-01
时间: 15:00

当前状况:
温度: 22.3°C
天空状况: 大部晴朗
降水类型: 无
降水概率: 0%
湿度: 45%
风向: 西北
风速: 2.3 m/s

逐小时预报:
16:00 - 温度: 21.8°C, 天空: 晴朗, 降水: 无
17:00 - 温度: 20.5°C, 天空: 晴朗, 降水: 无
18:00 - 温度: 19.2°C, 天空: 晴朗, 降水: 无
...

💻 使用例

グリッド座標の取得

location = get_grid_location("서울특별시", "서초구", "양재1동")
print(location)
# 出力：{'nx': 61, 'ny': 125}

天気予報の取得

forecast = get_forecast("서울특별시", "서초구", "양재1동", 61, 125)
print(forecast)

貢献者

• [Your Name] (your.email@example.com)

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。