How do I use Weather MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type `@` followed by the MCP server name and your instructions, e.g., "`@Weather MCP Server` what's the 5-day forecast for Shanghai in Celsius?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a [step-by-step guide with screenshots](https://glama.ai/blog/2025-07-08-how-to-install-and-use-mcp-servers).

🌤️ MCP Weather Server / 全球天气MCP服务器

npm version License: MIT

A powerful Model Context Protocol (MCP) server that provides global weather information with special support for Chinese cities. Perfect for AI assistants like Claude to access real-time weather data.

一个强大的模型上下文协议(MCP)服务器，提供全球天气信息，特别优化了对中国城市的支持。

✨ Features / 功能特性

🌍 Global Weather Support / 全球天气支持

Current Weather - Real-time weather for any city worldwide / 全球任意城市的实时天气
5-Day Forecast - Detailed weather forecasts / 详细的5天天气预报
Chinese Cities - Native support for Chinese city names / 原生支持中文城市名称
Multiple Units - Celsius, Fahrenheit, Kelvin / 摄氏度、华氏度、开尔文

🇺🇸 US-Specific Features / 美国专用功能

Weather Alerts - State-level weather alerts / 州级天气警报
Coordinate Forecasts - Precise location-based forecasts / 基于坐标的精确预报

📦 Installation / 安装

npm install -g @chenxming/mcp-weather-server

Or use without installation:

npx @chenxming/mcp-weather-server

🚀 Quick Start / 快速开始

1. Get API Key / 获取API密钥

Get a free API key from OpenWeatherMap

在 OpenWeatherMap 注册获取免费API密钥

2. Configure MCP Client / 配置MCP客户端

Add to your MCP client configuration:

{ "mcpServers": { "weather": { "command": "npx", "args": ["@chenxming/mcp-weather-server"], "env": { "OPENWEATHER_API_KEY": "your_api_key_here" } } } }

3. Alternative: Local Installation / 本地安装方式

{ "mcpServers": { "weather": { "command": "mcp-weather", "env": { "OPENWEATHER_API_KEY": "your_api_key_here" } } }

🛠️ Available Tools / 可用工具

🌐 Global Weather Tools / 全球天气工具

`get-current-weather`

Get current weather for any city worldwide / 获取任意城市的当前天气

Parameters / 参数:

city (required): City name in Chinese or English / 城市名称，支持中英文
country (optional): Country code like CN, US / 国家代码
units (optional): Temperature unit / 温度单位
- metric (default): Celsius / 摄氏度
- imperial: Fahrenheit / 华氏度
- kelvin: Kelvin / 开尔文

Examples / 示例:

Beijing: city: "北京" or city: "Beijing", country: "CN"
New York: city: "New York", country: "US"

`get-weather-forecast`

Get 5-day weather forecast / 获取5天天气预报

Parameters / 参数:

city (required): City name / 城市名称
country (optional): Country code / 国家代码
units (optional): Temperature unit / 温度单位

🇺🇸 US-Specific Tools / 美国专用工具

`get-alerts`

Get weather alerts for US states / 获取美国州级天气警报

Parameters / 参数:

state (required): Two-letter state code / 两位字母州代码 (e.g., CA, NY)

`get-forecast`

Get coordinate-based forecast for US locations / 基于坐标的美国地区预报

Parameters / 参数:

latitude (required): Latitude (-90 to 90) / 纬度
longitude (required): Longitude (-180 to 180) / 经度

📝 Usage Examples / 使用示例

Query Chinese Cities / 查询中国城市

{ "tool": "get-current-weather", "parameters": { "city": "上海", "units": "metric" } }

Query Global Forecast / 查询全球预报

{ "tool": "get-weather-forecast", "parameters": { "city": "London", "country": "GB" } }

US Weather Alerts / 美国天气警报

{ "tool": "get-alerts", "parameters": { "state": "CA" } }

🌏 Supported Cities / 支持的城市

🇨🇳 China: Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu...
🇺🇸 United States: New York, Los Angeles, Chicago, Houston...
🌍 Global: London, Tokyo, Paris, Sydney, Seoul, Mumbai...
✅ Chinese & English city names supported / 支持中英文城市名

🔧 Development / 开发

Local Setup / 本地设置

git clone https://github.com/chenxming/mcp-weather-server.git cd mcp-weather-server npm install npm run build

Development Mode / 开发模式

npm run dev # Watch mode

📊 API Data Sources / API数据源

Global Weather: OpenWeatherMap API / 全球天气：OpenWeatherMap API
US Weather: National Weather Service (NWS) API / 美国天气：国家气象服务API

⚡ Requirements / 系统要求

Node.js >= 18.0.0
OpenWeatherMap API key (free) / OpenWeatherMap API密钥（免费）

📄 License / 许可证

MIT License - see LICENSE file

🤝 Contributing / 贡献

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

🐛 Issues / 问题报告

Report issues at: https://github.com/chenxming/mcp-weather-server/issues

📞 Support / 支持

GitHub Issues: Bug reports and feature requests
Email: your.email@example.com

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Weather MCP Server

🌤️ MCP Weather Server / 全球天气MCP服务器

✨ Features / 功能特性

🌍 Global Weather Support / 全球天气支持

🇺🇸 US-Specific Features / 美国专用功能

📦 Installation / 安装

🚀 Quick Start / 快速开始

1. Get API Key / 获取API密钥

2. Configure MCP Client / 配置MCP客户端

3. Alternative: Local Installation / 本地安装方式

🛠️ Available Tools / 可用工具

🌐 Global Weather Tools / 全球天气工具

`get-current-weather`

`get-weather-forecast`

🇺🇸 US-Specific Tools / 美国专用工具

`get-alerts`

`get-forecast`

📝 Usage Examples / 使用示例

Query Chinese Cities / 查询中国城市

Query Global Forecast / 查询全球预报

US Weather Alerts / 美国天气警报

🌏 Supported Cities / 支持的城市

🔧 Development / 开发

Local Setup / 本地设置

Development Mode / 开发模式

📊 API Data Sources / API数据源

⚡ Requirements / 系统要求

📄 License / 许可证

🤝 Contributing / 贡献

🐛 Issues / 问题报告

📞 Support / 支持

Resources

New MCP Servers

Latest Blog Posts

MCP directory API