
Caiyun Weather MCP Server
Model Context Protocol (MCP) server for the Caiyun Weather API
what is Caiyun Weather MCP Server?
Caiyun Weather MCP Server is a Model Context Protocol (MCP) server designed to provide access to the Caiyun Weather API, offering tools for retrieving weather data including real-time conditions, forecasts, and alerts.
how to use Caiyun Weather MCP Server?
To use the server, you need to have Node.js (v16 or above) and a Caiyun Weather API token. After setting up the configuration, you can access various weather tools through the server.
key features of Caiyun Weather MCP Server?
- Real-time weather conditions
- Hourly weather forecasts (up to 72 hours)
- Daily weather forecasts (up to 7 days)
- Historical weather data
- Weather alerts
- Multi-language support (Chinese, English, Japanese)
- Token-efficient compact response format
use cases of Caiyun Weather MCP Server?
- Accessing current weather conditions for a specific location.
- Obtaining hourly and daily weather forecasts for planning activities.
- Retrieving historical weather data for research or analysis.
- Monitoring weather alerts for safety and preparedness.
FAQ from Caiyun Weather MCP Server?
- What do I need to run the Caiyun Weather MCP Server?
You need Node.js (v16 or above) and a Caiyun Weather API token.
- Can I get weather data for any location?
Yes, you can retrieve weather data by providing the longitude and latitude of the desired location.
- Is the server free to use?
The server is free to use, but you need a valid Caiyun Weather API token.
Caiyun Weather MCP Server
This is a Model Context Protocol (MCP) server for the Caiyun Weather API. It provides tools to access weather data including real-time conditions, forecasts, and weather alerts.
Features
- Real-time weather conditions
- Hourly weather forecasts (up to 72 hours)
- Daily weather forecasts (up to 7 days)
- Weather alerts
- Support for multiple languages (Chinese, English, Japanese)
- Token-efficient compact response format
Prerequisites
- Node.js (v16 or above)
- A Caiyun Weather API token (obtain one from Caiyun Weather API docs)
Configuration
{
"mcpServers": {
"caiyun-mcp-tools": {
"command": "npx",
"args": [
"caiyun-mcp-tools"
],
"env": {
"CAIYUN_API_KEY": "your-caiyun-api-key"
}
}
}
}
Available Tools
The server provides the following tools which can be accessed through Cursor:
-
realtime-weather - Get current weather conditions
- Parameters:
longitude
(number): Longitude coordinatelatitude
(number): Latitude coordinatelang
(optional string): Language for response ("zh_CN", "en_US", or "ja"), defaults to "zh_CN"
- Parameters:
-
hourly-forecast - Get hourly weather forecast
- Parameters:
longitude
(number): Longitude coordinatelatitude
(number): Latitude coordinatehourlysteps
(optional number): Number of hourly forecasts to return (max: 72)lang
(optional string): Language for response ("zh_CN", "en_US", or "ja"), defaults to "zh_CN"
- Parameters:
-
daily-forecast - Get daily weather forecast
- Parameters:
longitude
(number): Longitude coordinatelatitude
(number): Latitude coordinatedailysteps
(optional number): Number of daily forecasts to return (max: 7)lang
(optional string): Language for response ("zh_CN", "en_US", or "ja"), defaults to "zh_CN"
- Parameters:
-
weather-alerts - Get active weather alerts
- Parameters:
longitude
(number): Longitude coordinatelatitude
(number): Latitude coordinatelang
(optional string): Language for response ("zh_CN", "en_US", or "ja"), defaults to "zh_CN"
- Parameters:
API Limitations
Per the official Caiyun Weather API documentation: "The API interface only supports returning historical data for the past day." Due to this limitation, the historical weather tool has been removed from this package.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT