Skillget

mcp-caiyun-weather

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 32 GitHub stars
Code Gecti
  • Code scan — Scanned 8 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This server acts as a bridge allowing AI models to fetch real-time, forecasted, and historical weather data using the Caiyun (ColorfulClouds) Weather API.

Security Assessment
Overall risk: Low. The tool requires an API token to function, which is securely loaded via standard environment variables rather than being hardcoded into the source code. It makes external network requests to fetch weather data, which is its intended function. It does not request dangerous local system permissions, and the codebase scan found no malicious patterns, hidden shell execution, or access to unrelated sensitive local data. The only sensitive information passed through the tool is the longitude and latitude coordinates you ask it to look up.

Quality Assessment
The project demonstrates strong basic health indicators. It is licensed under the permissive and standard MIT license. The repository has been updated very recently, indicating active maintenance. While the community is relatively small, the project has earned over 30 GitHub stars, showing a baseline of peer recognition and trust. Its lightweight footprint (only 8 files scanned) makes it easy to manually audit and highly transparent.

Verdict
Safe to use.
SUMMARY

A Model Context Protocol (MCP) server for Caiyun (ColorfulClouds) Weather.

README.md

Caiyun Weather MCP Server

Setup Instructions

Before anything, ensure you have access to the API. You can apply for it at https://docs.caiyunapp.com/weather-api/.

Install uv first.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Setup with Claude Desktop

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": ["mcp-caiyun-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Ask Claude a question requiring weather

e.g. "What's the weather in Beijing Now?"

Local/Dev Setup Instructions

Setup with Claude Desktop

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
        "run",
        "mcp-caiyun-weather"
      ],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Debugging

Run:

npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
      run \
      mcp-caiyun-weather

Available Tools

  • get_realtime_weather: Get real-time weather data for a specific location

    • Parameters:
      • lng: The longitude of the location
      • lat: The latitude of the location
    • Returns detailed information including:
      • Temperature
      • Humidity
      • Wind speed and direction
      • Precipitation intensity
      • Air quality metrics (PM2.5, PM10, O3, SO2, NO2, CO)
      • AQI (China and USA standards)
      • Life indices (UV and Comfort)

  • get_hourly_forecast: Get hourly weather forecast for the next 72 hours

    • Parameters:
      • lng: The longitude of the location
      • lat: The latitude of the location
    • Returns hourly forecast including:
      • Temperature
      • Weather conditions
      • Rain probability
      • Wind speed and direction

  • get_weekly_forecast: Get daily weather forecast for the next 7 days

    • Parameters:
      • lng: The longitude of the location
      • lat: The latitude of the location
    • Returns daily forecast including:
      • Temperature range (min/max)
      • Weather conditions
      • Rain probability

  • get_historical_weather: Get historical weather data for the past 24 hours

    • Parameters:
      • lng: The longitude of the location
      • lat: The latitude of the location
    • Returns historical data including:
      • Temperature
      • Weather conditions

  • get_weather_alerts: Get weather alerts for a specific location

    • Parameters:
      • lng: The longitude of the location
      • lat: The latitude of the location
    • Returns weather alerts including:
      • Alert title
      • Alert code
      • Alert status
      • Alert description

Note: All tools require a valid Caiyun Weather API token to be set in the environment variable CAIYUN_WEATHER_API_TOKEN.

Yorumlar (0)

Sonuc bulunamadi