Caiyun Weather MCP Server

🚀 Qingyun Weather MCP Server

An MCP server that provides seamless access to the Qingyun Weather API.

🚀 Quick Start

1. Register and Obtain an API Key

Visit Qingyun Platform to register and generate your API key.

2. Clone the Repository and Set Up the Environment

Clone the repository and use uv to create a Python virtual environment and install dependencies.

git clone https://github.com/mrchi/caiyun-weather-mcp-server.git
cd caiyun-weather-mcp-server/
uv venv
uv sync

3. Configure Environment Variables

Create a .env file to store your API key.

CAIYUN_API_KEY="your-key"

4. Configure the MCP Client

Open a compatible MCP client, such as Claude for Desktop or Cline in VSCode, and configure it as follows:

{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "env": {},
            "args": [
                "--directory",
                "<your repo directory>",
                "run",
                "--env-file",
                ".env",
                "servers/caiyun_weather.py"
            ]
        }
    }
}

5. Query the Weather

Simply ask:

What's the weather like in Tiananmen Square?