caiyun-mcp-tools
If you are the rightful owner of caiyun-mcp-tools and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a Model Context Protocol (MCP) server for the Caiyun Weather API, providing tools to access weather data including real-time conditions, forecasts, and weather alerts.
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
