get-weather-forecastLABSCO SUMMARY
A narrow server that says exactly what it is.
The README is candid that this follows the MCP documentation's own weather demo, and the shape shows it: two tools, one data source, no abstraction layer. That is a fair trade when the requirement is Chinese city weather specifically, since the underlying API covers cities that global weather services describe thinly. The key is not a setting: it is a constant in src/index.ts, and the repository ships with the author's own. Put yours in before you build.
What it is
A small MCP server over the QWeather API, covering cities in mainland China, Hong Kong, Macau and Taiwan. You ask by Chinese city name; it resolves the city and returns either a forecast or the active meteorological warnings.
What you get
get-weather-forecasttakes acityname and an optionaldayscount from 1 to 7, defaulting to 3- Each forecast day carries high and low temperature, daytime and night-time conditions, wind direction and force, humidity, precipitation, pressure, visibility, the UV index, and sunrise and sunset times
get-weather-warningstakes acityand returns the active alerts with title, type, severity level, affected area, start time and full text- City coverage runs from the four municipalities down to county-level cities
Requirements
A free API key from the QWeather developer platform. The project is Node.js: npm install then npm run build, after which the client launches the compiled build/index.js with node. The package is china-weather-mcp, version 1.0.0. Errors are handled for an invalid or missing key, an unknown city name, network failure, and API request limits.
Setup effort
Build from source — git clone https://github.com/nanchengjiumeng/china-weather-mcp.git
USE CASES
01
Getting a week's forecast for a Chinese city
Ask by city name and set the day count, up to seven days ahead.
02
Checking whether a warning is active somewhere
Read the current meteorological alerts for a city, including severity and affected area.
03
Planning around conditions, not just temperature
Read wind, precipitation, visibility and UV index in the same response as the temperature range.
2 tools
Listed in project docs. Your client may show a different list.
get-weather-warningsBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/nanchengjiumeng/china-weather-mcp.git
cd china-weather-mcpOpen src/index.ts and set QWEATHER_API_BASE and API_KEY to your own API host and key from the QWeather developer console (https://dev.qweather.com) — the file ships with the author's values, and the key is read from the source, not from an environment variable
TERMINAL
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"weather": {
"command": "node",
"args": [
"<YOUR_DIR>/weather/build/index.js"
]
}
}
}<YOUR_DIR>/weather is the full path to your china-weather-mcp clone. The server runs build/index.js from there.
