MCP server that provides comprehensive weather and air quality information through the Open-Meteo API, supporting multiple transport modes including stdio, HTTP SSE, and streaming HTTP.

Installation

Smithery

npx -y @smithery/cli install @isdaniel/mcp_weather_server

Pip

pip install mcp_weather_server

HTTP Server (with dependencies)

pip install mcp_weather_server starlette uvicorn

Configuration

MCP Client (cline_mcp_settings.json)

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": [
        "-m",
        "mcp_weather_server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

Tool	Description
get_current_weather	Get current weather for a city with comprehensive metrics including temperature, humidity, wind, ...
get_weather_by_datetime_range	Get weather data for a date range with hourly details and trend analysis
get_weather_details	Get detailed weather information as structured JSON data for programmatic use
get_air_quality	Get air quality information with pollutant levels and health recommendations
get_air_quality_details	Get detailed air quality data as structured JSON for analysis
get_current_datetime	Get current time in any timezone using IANA timezone names
get_timezone_info	Get timezone information including offset and daylight saving time details
convert_time	Convert time between different timezones

Features

• Current weather with temperature, humidity, wind, precipitation, UV index, and visibility
• Historical weather data with hourly details across date ranges
• Air quality monitoring with PM2.5, PM10, ozone, and other pollutants
• Health recommendations and advice based on air quality
• Timezone operations and time conversion
• Multiple transport modes: stdio, HTTP SSE, and streaming HTTP
• No API key required - uses free Open-Meteo API
• Stateful and stateless modes for HTTP
• RESTful API endpoints through Starlette integration

Usage Examples

What's the current weather in Tokyo?

Get weather data for Paris from January 1st to January 7th

What's the air quality in Beijing right now?

What time is it in New York?

Convert 2PM UTC to Tokyo time

Notes

Supports three server modes: stdio (default for desktop clients), SSE (for web applications), and streamable-http (modern MCP protocol). Can run with customizable host/port and debug mode. Provides both human-readable responses and structured JSON data for programmatic use.