Openweather MCP Server

🚀 OpenWeather MCP 服務器

OpenWeather MCP 服務器是一個簡單的天氣預報 MCP（模型控制協議）服務器，它能提供全球天氣預報和當前天氣狀況，幫助用戶輕鬆獲取各地的天氣信息。

🚀 快速開始

安裝要求

pip install mcp-server requests pydantic

運行步驟

1. 獲取 OpenWeatherMap API 密鑰

訪問 OpenWeatherMap 註冊賬戶並獲取 API 密鑰。

2. 運行服務器

提供 API 密鑰有以下兩種方式：

方法 1：使用環境變量

# 設置環境變量
export OPENWEATHER_API_KEY="your_api_key"  # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key  # Windows

# 啟動服務器
python weather_mcp_server.py

方法 2：運行時提供

直接運行而不設置環境變量：

python weather_mcp_server.py

當調用工具時，需要提供 api_key 參數。

3. 在 MCP 客戶端配置中使用

將以下配置添加到支持 MCP 的客戶端中：

{
  "weather_forecast": {
    "command": "python",
    "args": [
      "/full_path/weather_mcp_server.py"
    ],
    "env": {
      "OPENWEATHER_API_KEY": "your_openweathermap_key_here"
    },
    "disabled": false,
    "autoApprove": ["get_weather", "get_current_weather"]
  }
}

4. 可用工具

get_weather

獲取指定位置的當前天氣和預報。 參數：

• location：地點名稱，例如“北京”、“紐約”、“東京”
• api_key：OpenWeatherMap API 密鑰（可選，默認從環境變量讀取）
• timezone_offset：時區偏移量（小時），例如 8 表示北京，-4 表示紐約。默認為 0（UTC 時間）

get_current_weather

獲取指定位置的當前天氣。 參數：

• location：地點名稱，例如“北京”、“紐約”、“東京”
• api_key：OpenWeatherMap API 密鑰（可選，默認從環境變量讀取）
• timezone_offset：時區偏移量（小時），例如 8 表示北京，-4 表示紐約。默認為 0（UTC 時間）

✨ 主要特性

• 無需單獨配置文件；API 密鑰可通過環境變量或參數直接傳遞
• 支持全球任意地點的天氣查詢
• 提供當前天氣和未來預報
• 詳細的天氣信息，包括溫度、溼度、風速等
• 支持不同時區

💻 使用示例

基礎用法

用戶：紐約現在的天氣怎麼樣？

AI：讓我幫你查看紐約的當前天氣。
[調用 get_current_weather("New York", timezone_offset=-4)]

紐約當前天氣：18°C，多雲，溼度 65%，風速 3.5m/s。

🔧 技術細節

故障排除

如果出現“未提供 API 密鑰”的錯誤，請確保：

1. 已在環境變量中設置了 OPENWEATHER_API_KEY，或
2. 在調用工具時提供了 api_key 參數

如果地點名稱不正確，可能會收到“位置未找到”的錯誤。嘗試使用更準確的 city 名稱或添加國家代碼，例如“Beijing,CN”或“Paris,FR”。