ctermiii/weather-mcp-metro

Weather MCP Server

基于 Open-Meteo API 的 MCP (Model Context Protocol) 天气服务器，为 LLM 大模型提供实时天气查询功能。

功能特性

• 支持中英文城市名称查询
• 自动地理编码（城市名→坐标）
• 获取7天天气预报
• 详细的天气信息包括：
  • 温度: 最高/最低温度、体感温度
  • 风力: 风速、阵风、风向
  • 舒适度: 基于温度和湿度的舒适度评估
  • 天气状况: 晴、雨、雪等详细描述
  • 降水信息: 降水量、降雨量、降雪量
  • 其他: 日出日落时间、湿度等

安装

npm install

使用方法

1. 配置 MCP 客户端

在 Claude Desktop 或其他 MCP 客户端的配置文件中添加：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/Users/wanli/.config/mcp/weather-mcp-metro/index.js"]
    }
  }
}

2. 启动服务器

npm start

3. 在 LLM 中使用

服务器提供了一个工具 get_weather，可以通过以下方式调用：

请帮我查询北京的天气

或

What's the weather like in Shanghai?

API 说明

get_weather

获取指定城市的天气预报信息。

参数:

• city (string, 必需): 城市名称，支持中英文

返回示例:

{
  "城市信息": {
    "名称": "Beijing",
    "国家": "China",
    "坐标": "39.9075, 116.39723",
    "时区": "Asia/Shanghai"
  },
  "当前天气": {
    "时间": "2025-10-17T10:00",
    "温度": "18°C",
    "体感温度": "16°C",
    "湿度": "65%",
    "天气状况": "部分多云",
    "风速": "12 km/h",
    "风向": "东北",
    "舒适度": "舒适"
  },
  "七天预报": [
    {
      "日期": "2025-10-17",
      "最高温度": "22°C",
      "最低温度": "14°C",
      "天气状况": "部分多云",
      "降水量": "0mm",
      "降雨量": "0mm",
      "降雪量": "0cm",
      "最大风速": "15 km/h",
      "最大阵风": "25 km/h",
      "主导风向": "东",
      "日出": "2025-10-17T06:30",
      "日落": "2025-10-17T18:15",
      "舒适度": "舒适"
    }
    // ... 其余6天
  ]
}

技术细节

数据来源

• 地理编码 API: https://geocoding-api.open-meteo.com/v1/search
• 天气数据 API: https://api.open-meteo.com/v1/forecast

天气参数

• temperature_2m_max/min: 最高/最低温度
• weathercode: 天气代码（自动转换为中文描述）
• precipitation_sum: 总降水量
• rain_sum: 降雨量
• snowfall_sum: 降雪量
• windspeed_10m_max: 最大风速
• windgusts_10m_max: 最大阵风
• winddirection_10m_dominant: 主导风向
• sunrise/sunset: 日出日落时间
• relative_humidity_2m: 相对湿度
• apparent_temperature: 体感温度

舒适度评级

基于体感温度和湿度计算：

• 非常寒冷 (< 0°C)
• 寒冷 (0-10°C)
• 凉爽 (10-16°C)
• 舒适 (16-24°C)
• 温暖 (24-28°C)
• 炎热 (28-32°C)
• 酷热 (> 32°C)

同时考虑湿度影响（高湿度/干燥提示）

依赖项

• @modelcontextprotocol/sdk: MCP SDK

许可证

MIT

注意事项

• Open-Meteo API 是免费开源的，无需 API 密钥
• 数据更新频率取决于 Open-Meteo 服务
• 建议合理使用，避免过于频繁的请求