qweather-mcp

English | 简体中文

通过模型上下文协议（MCP）提供全面天气信息查询能力的QWeather API服务器。

✨ 特性

• 🌤 实时天气查询
• 📅 多日天气预报（3/7/10/15/30天）
• 🔑 简单的API密钥配置
• 🔌 自定义API基础URL支持
• 🛠 完整工具集成

📦 安装

通过Smithery

推荐：使用Smithery自动安装到Claude桌面：

npx -y @smithery/cli install @overstarry/qweather-mcp --client claude

手动配置

1. 首先，从QWeather控制台获取您的API密钥。

2. 启动服务器：

# 标准IO服务器
npx -y qweather-mcp

3. 配置环境变量：

QWEATHER_API_BASE=https://api.qweather.com
QWEATHER_API_KEY=<your-api-key>

JSON配置

添加到您的配置文件中：

{
  "mcpServers": {
    "qweather": {
      "command": "npx",
      "args": ["-y", "qweather-mcp"],
      "env": {
        "QWEATHER_API_BASE": "<your-api-url>",
        "QWEATHER_API_KEY": "<your-api-key>"
      }
    }
  }
}

🛠 可用工具

get-weather-now

获取指定位置的当前天气信息。

get-weather-forecast

获取指定位置的天气预报信息，可自定义预报天数：

• 3天预报
• 7天预报
• 10天预报
• 15天预报
• 30天预报

预报数据包括：

• 温度范围（最低/最高）
• 白天/夜晚天气状况
• 日出/日落时间
• 降水量
• 湿度
• 风况
• 紫外线指数

get-minutely-precipitation

提供未来2小时内的逐分钟降水预报，包括：

• 降水类型（雨/雪）
• 每分钟降水量
• 精确时间预测
• 实时预报描述

get-hourly-forecast

提供未来24、72或168小时的逐小时天气预报，包括：

• 温度变化
• 天气状况
• 风向和风力
• 相对湿度
• 大气压力
• 降水概率
• 云量

get-weather-warning

提供实时天气警告信息，包括：

• 警告发布机构
• 警告级别和类型
• 详细警告内容
• 警告有效期限
• 相关建议

get-weather-indices

提供天气生活指数信息，支持多种指数类型：

• 运动指数
• 洗车指数
• 穿衣指数
• 钓鱼指数
• 紫外线指数
• 旅游指数
• 过敏指数 以及另外16种生活指数

get-air-quality

提供实时空气质量数据，包括：

• AQI指数
• 空气质量等级
• 主要污染物
• 健康建议
• 污染物浓度

get-air-quality-hourly

提供未来24小时的逐小时空气质量预报：

• 小时AQI预测
• 污染物浓度变化
• 健康影响评估
• 保护建议

get-air-quality-daily

提供未来3天的空气质量预报：

• 每日AQI预测
• 主要污染物预报
• 空气质量等级变化
• 健康保护建议

🤝 贡献

欢迎提交问题和改进！请参阅我们的贡献指南。

📄 许可证

MIT

🔗 相关链接

• QWeather官方网站
• API文档
• 控制台