Weather API MCP Server

Weather API MCP Server is an MCP server that connects LLM clients to the QWeather (和风天气) API to retrieve real-time weather reports, extended forecasts, hourly predictions, and geographical lookup data. Designed for developers and AI assistant users who require up-to-date meteorological information within chat interfaces, the server provides direct access to environmental metrics across global locations. Through standard Model Context Protocol tools, users can query current temperatures, humidity levels, wind speeds, atmospheric pressure, and visibility metrics for cities, specific coordinates, or QWeather location codes. It also facilitates retrieving 24-hour hourly projections along with daily forecasts spanning from 3 to 30 days, complete with sunrise, sunset, and moon phase data. The server enables automated location resolution using a dedicated city lookup tool, allowing users to discover specific location identifiers for more accurate weather tracking. Configurable options include measurement unit toggles between metric and imperial scales, multi-language support covering English, Chinese, and Japanese, and fine-tuned detail levels.

Category: Maps, Weather & Local Data

Tags: forecast, meteorology, qweather, weather

Visit Weather API MCP Server

How to install and configure Weather API MCP Server

1. Install the package locally using npm install mcp-weather-api or run it dynamically with npx. 2. Obtain an API key from the QWeather developer platform. 3. Open your MCP client configuration file (for example, claude_desktop_config.json for Claude Desktop). 4. Register the server in your mcpServers object: json { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "mcp-weather-api"], "env": { "QWEATHER_API_KEY": "your-api-key" } } } } 5. Save the configuration and restart your client to use the weather tools.

What you can do with Weather API MCP Server

• Querying real-time temperature, humidity, wind conditions, and visibility for specific coordinates or city names directly from an interactive AI prompt. - Retrieving 24-hour hourly weather projections to help AI agents generate detailed daily schedules or outdoor activity recommendations. - Fetching multi-day forecasts spanning up to 30 days to support long-term event scheduling, travel planning, or agricultural monitoring tasks. - Looking up precise QWeather city identification numbers and administrative region data to resolve location ambiguities before querying weather endpoints. - Customizing weather data output in preferred languages and measurement systems like metric or imperial to match specific localized user preferences.

Key facts

• https://github.com/yoyooyooo/mcp-weather-server
• Maps, Weather & Local Data
• forecast, meteorology, qweather, weather

Part of MCP Servers

What can Weather API MCP Server do?

Weather API MCP Server provides four main tools to fetch current weather conditions, 24-hour hourly forecasts, 3- to 30-day extended daily forecasts, and city lookup details. It surfaces meteorological data such as temperature, feels-like temperature, humidity, wind speed, pressure, visibility, cloud cover, and sunrise or sunset times directly to supported MCP assistants.

How do I install Weather API MCP Server?

You can install the server via npm using npm install mcp-weather-api or run it directly using npx. In your MCP client configuration file, add an entry under mcpServers specifying npx as the command and -y mcp-weather-api as the arguments, along with your QWeather API credentials in the environment variables.

Which MCP clients work with Weather API MCP Server?

Weather API MCP Server works with any client that implements the standard Model Context Protocol. This includes AI desktop clients like Claude Desktop, developer environments like Cursor, and other custom agent platforms configured to run local MCP servers via standard input and output.

What location formats are supported by Weather API MCP Server?

The server supports three location formats: standard city names such as London or Beijing, geographic coordinates specified as longitude,latitude (for example 119.98,30.24), and official QWeather location ID codes obtained via the city lookup tool.

Does Weather API MCP Server require an API key?

The server integrates with the QWeather API. While an initial demo key is bundled for evaluation purposes, production usage requires setting the QWEATHER_API_KEY environment variable with a personal key obtained from the QWeather developer portal.