Caiyun Weather MCP
A Model Context Protocol (MCP) server for Caiyun (ColorfulClouds) Weather.
What is Caiyun Weather MCP?
Caiyun Weather MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for caiyun (colorfulclouds) weather.
A Model Context Protocol (MCP) server for Caiyun (ColorfulClouds) Weather.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server for Caiyun (ColorfulCl
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-caiyun-weatherConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Caiyun Weather MCP
The Caiyun Weather MCP Server connects AI assistants to the Caiyun (ColorfulClouds) weather API, providing real-time conditions, hourly and weekly forecasts, historical data, and active weather alerts for any location worldwide. It exposes five dedicated tools that accept longitude and latitude coordinates, making it easy for Claude to answer weather questions with authoritative, up-to-date data. Developers and end users who need accurate, location-based weather information embedded directly into AI conversations will find this server a straightforward solution.
Prerequisites
- Python runtime via uv (install with: curl -LsSf https://astral.sh/uv/install.sh | sh)
- A Caiyun Weather API token — register at https://docs.caiyunapp.com/weather-api/ to obtain one
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
Install uv (Python package runner)
Caiyun Weather MCP is distributed as a Python package and runs via uvx. Install uv first if you do not already have it.
curl -LsSf https://astral.sh/uv/install.sh | shObtain a Caiyun Weather API token
Visit https://docs.caiyunapp.com/weather-api/ and sign up for a developer account. After registration, copy your API token — you will need it as the CAIYUN_WEATHER_API_TOKEN environment variable.
Verify the server runs correctly
Before configuring your MCP client, confirm the server starts without errors by running it directly with uvx.
CAIYUN_WEATHER_API_TOKEN=your_token_here uvx mcp-caiyun-weatherAdd the server to your MCP client configuration
Open your claude_desktop_config.json (or equivalent MCP client config) and add an entry for the Caiyun Weather server, passing your API token as an environment variable.
Restart your MCP client and test
Restart Claude Desktop (or your chosen client) to load the new server. Ask Claude a weather question for any city to confirm the tools are working.
Caiyun Weather MCP Examples
Client configuration
Add this block to the mcpServers section of your claude_desktop_config.json. Replace your_token_here with your actual Caiyun API token.
{
"mcpServers": {
"caiyun-weather": {
"command": "uvx",
"args": ["mcp-caiyun-weather"],
"env": {
"CAIYUN_WEATHER_API_TOKEN": "your_token_here"
}
}
}
}Prompts to try
Once connected, ask Claude weather questions and it will call the appropriate tool automatically.
- "What is the current weather in Beijing right now?"
- "Give me the 72-hour hourly forecast for Shanghai."
- "What does the 7-day outlook look like for Chengdu?"
- "Are there any active weather alerts in Guangzhou?"
- "What was the weather like in Shenzhen yesterday?"Troubleshooting Caiyun Weather MCP
Server fails to start with an authentication error
Double-check that CAIYUN_WEATHER_API_TOKEN is set correctly with no extra spaces. Verify the token is active by testing it against the Caiyun API directly using curl: curl 'https://api.caiyunapp.com/v2.6/YOUR_TOKEN/116.40,39.92/realtime.json'
uvx command not found after installation
After running the uv install script, restart your terminal or run `source ~/.bashrc` (or `~/.zshrc`) to reload your PATH so the uvx binary is accessible.
Weather tools return location not found or empty results
The tools require longitude and latitude coordinates, not city names. Claude should resolve city names to coordinates automatically, but if it does not, specify coordinates explicitly: e.g., 'Get the weather at longitude 116.40, latitude 39.92 (Beijing)'.
Frequently Asked Questions about Caiyun Weather MCP
What is Caiyun Weather MCP?
Caiyun Weather MCP is a Model Context Protocol (MCP) server that model context protocol (mcp) server for caiyun (colorfulclouds) weather. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Caiyun Weather MCP?
Follow the installation instructions on the Caiyun Weather MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Caiyun Weather MCP?
Caiyun Weather MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Caiyun Weather MCP free to use?
Yes, Caiyun Weather MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Caiyun Weather MCP Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Caiyun Weather MCP? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Caiyun Weather MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Caiyun Weather MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.