中国天气查询 MCP 服务器

照抄Mcp官网Demo的基于和风天气API的Model Context Protocol (MCP)服务器，用于查询中国城市的天气信息和气象预警。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json 

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "your_dir/weather/build/index.js"
      ]
    }
  }
}

功能特性

• 🌤️ 天气预报: 获取中国任意城市的1-7天天气预报
• ⚠️ 气象预警: 查询城市的实时气象预警信息
• 🏙️ 智能城市搜索: 支持中文城市名称搜索
• 📊 详细信息: 提供温度、湿度、风力、降水、紫外线等详细天气数据

安装和配置

1. 获取API密钥

访问 和风天气开发平台 注册账号并获取免费的API密钥。

2. 设置环境变量

const QWEATHER_API_BASE = "https://ph5ctubwqh.re.qweatherapi.com";
const API_KEY = "dedccbe28e4d43a28e9db478df8aca71";

3. 安装依赖

npm install

4. 构建项目

npm run build

可用工具

1. get-weather-forecast

获取城市天气预报

参数:

• `city` (string): 城市名称，如：北京、上海、广州等
• `days` (number, 可选): 预报天数，1-7天，默认3天

示例:

{
  "city": "北京",
  "days": 5
}

2. get-weather-warnings

获取城市气象预警信息

参数:

• `city` (string): 城市名称，如：北京、上海、广州等

示例:

{
  "city": "上海"
}

支持的城市

支持中国大陆、港澳台地区的所有主要城市，包括但不限于：

• 直辖市: 北京、上海、天津、重庆
• 省会城市: 广州、深圳、杭州、南京、武汉、成都、西安等
• 地级市: 苏州、无锡、佛山、东莞、大连等
• 县级市: 昆山、江阴、张家港等

数据说明

天气预报包含以下信息：

• 📅 日期
• 🌡️ 最高/最低温度
• ☀️ 白天天气状况
• 🌙 夜间天气状况
• 💨 风向风力
• 💧 湿度
• 🌧️ 降水量
• 📊 气压
• 👁️ 能见度
• ☀️ 紫外线指数
• 🌅 日出日落时间

气象预警包含：

• ⚠️ 预警标题和类型
• 📊 预警等级
• 📍 影响区域
• ⏰ 生效时间
• 📋 详细描述

错误处理

服务器会处理以下常见错误：

• API密钥无效或未设置
• 城市名称不存在
• 网络连接问题
• API请求限制

开发

项目结构

weather/
├── src/
│   └── index.ts          # 主服务器文件
├── build/
│   └── index.js          # 编译后的文件
├── package.json
├── tsconfig.json
└── README.md

本地开发

1. 修改源代码 `src/index.ts`

2. 重新构建: `npm run build`

3. 测试运行: `npm start`

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

相关链接

• 和风天气API文档
• Model Context Protocol
• MCP SDK