Overview
What is Weather API MCP Server?
A Model Context Protocol (MCP) server implementation for weather information, providing current weather data and forecasts using the 和风天气 (QWeather) API. It is intended for developers who want to integrate weather data into AI applications.
How to use Weather API MCP Server?
Install via npm install mcp-weather-api or run directly with npx mcp-weather-api. Add the server to your MCP configuration using the command and args shown in the README. Optionally configure environment variables for API key, default location, units, language, and forecast days.
Key features of Weather API MCP Server
- Current Weather data for any location
- 3‑day to 30‑day weather forecasts
- 24‑hour hourly forecasts
- City lookup by name or coordinates
- Customizable units (metric/imperial) and language
- Powered by the QWeather API
Use cases of Weather API MCP Server
- Retrieve current weather for a city in an AI assistant
- Generate a 7‑day forecast for travel planning
- Look up QWeather city IDs for precise location targeting
- Provide hourly weather updates for event scheduling
- Integrate weather data into smart home automation conversations
FAQ from Weather API MCP Server
What API key is used by the server?
A demo API key is included in the package. For production use, you should obtain your own API key from QWeather.
What location formats are supported?
You can use city names (e.g., “New York”), coordinates as “longitude,latitude” (e.g., “119.98,30.24”), or QWeather location IDs (e.g., “101010100” for Beijing).
How do I configure default units, language, or forecast days?
Set environment variables like WEATHER_DEFAULT_UNITS, WEATHER_DEFAULT_LANGUAGE, and WEATHER_FORECAST_DAYS before starting the server, or include them in the env section of your MCP configuration.
What is the response format of the tools?
All tools return an MCP content array with a single text item containing a human-readable string of weather information.
What is the maximum forecast period available?
The forecast tool supports 3, 7, 10, 15, or 30 days. The hourly forecast is limited to a maximum of 24 hours.
