AusbelDev/Skycast-MCP-server

SkyCast Weather MCP Server

A Model Context Protocol (MCP) server that fetches current, hourly, and daily weather forecasts for a specified place using the Open-Meteo APIs.

Purpose

This MCP server provides a secure, keyless interface for assistants to retrieve weather by human place names, with robust error handling and clear, formatted outputs.

Features

Current Implementation

• weather_current - Get current conditions (temp, feels like, humidity, wind, precip, weather code).
• weather_hourly - Get N hours of hourly forecast (default 24, clamp 1–168).
• weather_daily - Get N days of daily forecast (default 7, clamp 1–16).
• weather_raw - Return a trimmed raw JSON snapshot with optional custom query params.

APIs & Docs

• Forecast API: https://open-meteo.com/en/docs
• Geocoding API: https://open-meteo.com/en/docs/geocoding-api
• Authentication: None required.

Prerequisites

• Docker Desktop with MCP Toolkit enabled
• Docker MCP CLI plugin (docker mcp)
• Internet connectivity

Usage Examples

In Claude Desktop, try:

• "Get the current weather for Tokyo using metric units." → weather_current place="Tokyo" units="metric"
• "Hourly forecast for Boston for 12 hours in imperial." → weather_hourly place="Boston" hours="12" units="imperial"
• "Daily forecast for Madrid for 10 days." → weather_daily place="Madrid" days="10"
• "Show me the raw weather payload for Berlin." → weather_raw place="Berlin"

Architecture

Claude Desktop → MCP Gateway → SkyCast Weather MCP Server → Open-Meteo (Forecast + Geocoding) ↓ Docker Desktop (no secrets required)

Development

Local Testing

# Run directly
python skycast_server.py

# List tools via MCP protocol
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python skycast_server.py