Korean Weather

🚀 韓國天氣 MCP 服務器

這是一個使用多平臺通信協議（MCP）構建的韓國天氣服務器。它允許通過KMA（韓國氣象廳）的公開數據接口查詢即時天氣和超短期天氣預報，為用戶提供便捷的天氣查詢服務。

🚀 快速開始

1. 配置環境變量，指定KMA API的訪問密鑰。
2. 在主函數中啟動服務器：

from server import start_server

if __name__ == "__main__":
    start_server()

✨ 主要特性

• 使用網格座標(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

💻 使用示例

基礎用法

# 獲取網格座標
location = get_grid_location("서울특별시", "서초구", "양재1동")
print(location)
# 輸出：{'nx': 61, 'ny': 125}

# 獲取天氣預報
forecast = get_forecast("서울특별시", "서초구", "양재1동", 61, 125)
print(forecast)

高級用法

# 可以根據實際需求，在獲取網格座標和天氣預報的基礎上，進行更多的處理和分析。
# 例如，將獲取到的天氣預報信息存儲到文件中，或者進行可視化展示。

📚 詳細文檔

核心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, 天空: 晴朗, 降水: 無
...

📄 許可證

本項目採用 MIT 許可證，具體內容請參閱 LICENSE 文件。

貢獻者

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