Weekly Weather MCP

🚀 如何使用Weather MCP服務器

本項目提供了一個Weather MCP服務器，藉助OpenWeatherMap的One Call API 3.0，能夠獲取特定地區的當前天氣和未來8天的天氣預報，為用戶提供風速、降水量等詳細的天氣信息。

🚀 快速開始

安裝與配置

1. 安裝依賴項：

   pip install openweathermap-api python-multipart
   

2. 設置API密鑰：
   • 在環境變量中設置 OPENWEATHER_API_KEY：

     export OPENWEATHER_API_KEY="your_api_key"
     

   • 或者在代碼中直接傳遞 api_key 參數。
3. 運行服務器：

   python3 weather_mcp_server.py
   

✨ 主要特性

• 提供兩個實用工具：get_weather 和 get_current_weather。
• 採用OpenWeatherMap的One Call API 3.0。
• 支持8天天氣預報（涵蓋今天和未來7天）。
• 包含每個時間段的早間、午間和晚間天氣數據。
• 顯示風速、降水量和其他天氣摘要。

💻 使用示例

基礎用法

# 獲取當前天氣
python3 weather_mcp_server.py --current-weather --city New York

# 獲取天氣預報
python3 weather_mcp_server.py --weather-forecast --location "Beijing,China"

高級用法

• 支持多天天氣數據查詢（最多8天）。
• 可指定具體時間點的天氣信息。
• 提供詳細的氣象數據，包括降水量、風向等。

輸入輸出示例

示例輸入：

{
  "city": "New York",
  "state": "NY",
  "country": "US"
}

示例輸出：

{
  "current_weather": {
    "temperature": 22,
    "condition": "Partly Cloudy",
    "wind_speed": 12,
    "humidity": 65
  },
  "hourly_forecast": [...],
  "daily_forecast": [...]
}

📚 詳細文檔

問題排查

API密鑰問題

1. 確保已訂閱OpenWeatherMap的One Call API 3.0計劃。
2. 確認API密鑰在環境變量中正確設置。
3. 檢查是否有超過免費配額的情況。

其他常見問題

• 位置未找到：檢查輸入的準確性，嘗試添加國家代碼。
• 速率限制：減少API調用頻率或升級至付費計劃。

開發與測試

自動化測試

1. 單元測試：

   python test_weather_mcp.py
   

2. 集成測試：

   python integration_test.py
   

手動測試

# 運行測試客戶端
python3 weather_test_client.py --test-all

📄 最後更新

2023年11月4日