MCP Server Weather Forecast

🚀 天氣預報工具

本工具是一個 Python 代碼項目，藉助 MET Norway API 獲取並總結指定位置的天氣預報。它採用 FastMCP 框架進行工具註冊，運用 httpx 開展異步 HTTP 請求，為用戶提供精準、便捷的天氣預報服務。

🚀 快速開始

此天氣預報工具使用 Python 編寫，藉助 FastMCP 框架和 httpx 庫實現功能。以下為快速上手步驟：

1. 安裝必要依賴（Python 3.13+）。
2. 獲取所需位置的經緯度。
3. 導入必要模塊並初始化 FastMCP 服務器。
4. 調用 get_weather 函數獲取天氣預報。

✨ 主要特性

• 天氣預報獲取：get_weather 函數可根據指定的緯度和經度，從 MET Norway API 中獲取天氣預報數據。
• 每日天氣總結：summarize_daily_timeseries_most_occurrences 函數對原始預報數據進行處理，生成簡潔的每日天氣總結，涵蓋夜晚、早晨、下午和傍晚最頻繁出現的天氣符號，以及當天的最低和最高溫度，且預報以本地時間返回。
• 異步 HTTP 請求：make_net_request 函數負責對 MET Norway API 進行異步 HTTP 請求，提高數據獲取效率。
• 天氣符號映射：map_weather_symbol 函數將 API 中的天氣符號代碼轉換為易於理解的描述。

📦 安裝指南

安裝依賴項

需安裝 MCP 及其他所需依賴項（參見 MCP 文檔）。

獲取座標

使用該工具前，需指定位置的緯度和經度。

💻 使用示例

基礎用法

導入必要的模塊並初始化 FastMCP 服務器：

from collections import Counter
from datetime import datetime, timezone, timedelta
from mcp.server.fastmcp import FastMCP
from typing import Any
import asyncio
import json
import httpx

mcp = FastMCP("weather")

高級用法

使用 get_weather 工具獲取指定位置的天氣預報：

async def main():
    天氣數據 = await get_weather(55.6761, 12.5683) # 示例：丹麥哥本哈根
    print(天氣數據)

if __name__ == "__main__":
    asyncio.run(main())

將 55.6761 和 12.5683 替換為您所需的緯度和經度。

📚 詳細文檔

工具定義

• get_weather(緯度: float, 經度: float) -> str
  • 功能：獲取並格式化指定位置的天氣預報。
  • 參數：
    • 緯度 (float)：位置的緯度。
    • 經度 (float)：位置的經度。
  • 返回：包含每日天氣預報的格式化字符串。

MCP 相關

該代碼使用 FastMCP 框架。請參閱 FastMCP 文檔以瞭解如何設置和運行服務器。

📄 許可證

本項目採用 MIT License。