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 数据
}

说明

📄 许可证

此项目使用 MIT 许可证。