Qweather Mcp Server Unofficial

非官方 QWeather MCP

这是一个面向 QWeather API 的非官方 MCP（多 Agent 对话协议）封装包。该软件包提供工具，方便通过 MCP 访问 QWeather 全面的天气数据服务，并将其集成到 AI Agent、聊天机器人和其他应用中。

功能

• 城市查询：按名称、坐标、LocationID 或 Adcode 搜索城市
• 兴趣点查询：查找景点、车站等兴趣点
• 实时天气：获取全球各地的当前天气状况
• 天气预报：获取 3-30 天的每日预报和最长 7 天的逐小时预报
• 天气预警：获取实时灾害预警和各地区的预警列表
• 天气指数：获取紫外线指数、运动指数等生活指数
• 空气质量：获取实时和预报空气质量数据，以及详细的污染物信息

安装

pip install unoff-qweather-mcp

身份验证

此软件包需要 QWeather API 密钥。你需要：

1. 在 QWeather 开发者平台注册账号
2. 在开发者控制台中创建 API 密钥
3. 设置以下环境变量：

export QWEATHER_API_KEY="your_api_key_here"
export QWEATHER_API_HOST="api.qweather.com"  # or another appropriate host based on your subscription

API 主机取决于你的订阅层级。详情请参阅 QWeather API 配置。

用法

作为 Claude MCP 运行

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

# Clone and config the env
git clone https://github.com/HongpengM/unoff-qweather-mcp.git

# Set up your environment variables by copying the example file
copy env.example .env

# Run the MCP server
uv --directory /path/to/your_dir run src/unoff_qweather/qweather.py

使用已发布的版本：

{
  "mcpServers": {
    "qweather": {
      "command": "uvx",
      "args": [
        "unoff-qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_KEY": "your_api_key_here",
        "QWEATHER_API_HOST": "api.qweather.com" 
      }
    }
  }
}

使用本地克隆的仓库：

{
  "mcpServers": {
    "qweather": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your_dir",
        "run",
        "src/unoff_qweather/qweather.py"
      ],
      "env": {
        "QWEATHER_API_KEY": "your_api_key_here",
        "QWEATHER_API_HOST": "api.qweather.com" 
      }
    }
  }
}

可用工具

此软件包提供以下 MCP 工具：

• lookup_city - 按名称或坐标搜索城市
• lookup_poi - 查找兴趣点
• weather_now - 获取当前天气状况
• weather_forecast_days - 获取每日天气预报（3-30 天）
• weather_forecast_hours - 获取逐小时天气预报（24-168 小时）
• warning_city_list - 获取有生效天气预警的城市
• weather_warning - 获取指定地点的详细天气预警
• weather_indices - 获取生活指数（紫外线、运动等）
• air_quality_now - 获取当前空气质量数据
• air_quality_forecast - 获取空气质量预报

如需了解详细的参数信息，请参阅代码中各函数的文档字符串。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

免责声明

这是一个非官方封装，与 QWeather 无关联，也未获得其认可。使用此软件包时，用户必须遵守 QWeather 的服务条款。