Weather MCP Server

🚀 天氣 MCP 服務器

一個提供全球城市天氣信息的 Model Context Protocol (MCP) 服務器，能讓你輕鬆獲取各地的天氣詳情。

✨ 主要特性

• 🌍 獲取任何城市的當前天氣。
• 🌡️ 提供溫度、天氣狀況、溼度、風力信息等。
• 🛡️ API 請求失敗時 fallback 到 mock 數據。

📋 需求

• Node.js（v14 或更高版本）
• npm 或 yarn
• OpenWeather API 密鑰（可選 - 未提供時將使用 mock 數據）

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴：

   npm install
   

3. 構建服務器：

   npm run build
   

💻 使用示例

本地運行

npm start

與 Claude 或其他 MCP 兼容的 AI 助手一起使用

在你的 MCP 配置中添加以下內容：

{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": ["path/to/weather-server/build/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here" // 可選 - 未提供時將使用 mock 數據
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API 密鑰和 Mock 數據

此服務器有兩種運行模式：

1. 帶有 API 密鑰：當通過 OPENWEATHER_API_KEY 環境變量提供 OpenWeather API 密鑰時，服務器將從 OpenWeather API 獲取即時天氣數據。
2. 無 API 密鑰：如果沒有提供 API 密鑰，則服務器會自動為一組預定義城市（倫敦、紐約、東京、巴黎、悉尼）使用真實數據，並對其他城市使用默認 mock 數據。對於其他城市，默認使用 mock 數據。

要獲取 OpenWeather API 密鑰：

1. 在 OpenWeather 註冊。
2. 轉到你賬戶的“API keys”部分。
3. 生成新的 API 密鑰或使用現有密鑰。

在沒有 API 密鑰的情況下，mock 數據模式非常適合開發、測試或不需要即時天氣數據的情況。

可用工具 - get_current_weather

獲取指定城市的當前天氣信息。

輸入格式：

{
  "city": "string" // 城市名稱（例如，“倫敦”，“紐約”，“東京”）
}

示例響應：

{
  "location": "London, GB",
  "date": "2025年3月24日，星期一",
  "time": "下午7:30:00",
  "temperature": {
    "current": "12°C",
    "feelsLike": "10°C"
  },
  "weather": {
    "main": "多雲",
    "description": "陰雲密佈",
    "icon": " cloudy "
  },
  "wind": {
    "speed": 15,
    "direction": 270
  },
  "humidity": 80,
  "source": "openweather" // 來源標識符，可以是 openweather 或 mock 數據
}

說明：

• location：城市及其對應國家的標識符。
• date 和 time：天氣數據獲取的時間和日期。
• temperature：當前溫度和體感溫度。
• weather：當前天氣狀況，包括主要描述和圖標。
• wind：風速和方向（以度數表示，0 - 360 度）。
• humidity：相對溼度百分比。
• source：數據來源標識符，可以是 openweather 或 mock 數據。

📄 許可證

此項目使用 MIT 許可證。