weather-mcp-server

pangerl/weather-mcp-server

3.2

If you are the rightful owner of weather-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The weather-mcp-server is a weather query service based on the MCP protocol, utilizing the QWeather API for real-time weather data retrieval.

Tools
1
Resources
0
Prompts
0

weather-mcp-server

项目简介

本项目是一个基于 MCP 协议的天气查询服务，支持通过城市名、LocationID 或经纬度查询实时天气，底层调用和风天气 API。

依赖环境

  • Python 3.12 及以上
  • mcp[cli]（通过 pyproject.toml 管理）
  • requests

安装依赖

pip install -r requirements.txt
# 或者
pip install "mcp[cli]" requests

环境变量

需配置以下环境变量：

  • QWEATHER_API_HOST：和风天气 API Host，例如 https://devapi.qweather.com
  • QWEATHER_API_KEY：和风天气 API Key

启动方式

python main.py

工具接口

  • get_forecast
    • 描述：查询实时天气，location 可为城市名称、LocationID 或经纬度。推荐传城市名，自动查ID。
    • 参数：
      • location（string，必填）：查询的地理位置（如城市名称、LocationID 或经纬度，推荐城市名）

主要代码说明

  • get_forecast(params)：主工具函数，自动判断 location 类型，必要时先查 LocationID，再查天气。
  • query_location_id：通过城市名查 LocationID。
  • query_qweather_now：通过 LocationID 或经纬度查实时天气。
  • 错误处理通过 ToolResultError 返回，正常结果用 ToolResultText。

运行日志

服务启动后会输出日志，便于排查问题。