What is Mcp Openweather

mcp-openweather is an MCP server that utilizes the free OpenWeatherMap API to provide current weather conditions and a 5-day weather forecast.

Use cases

Use cases include providing weather updates in applications, integrating weather data into smart home systems, and offering weather forecasts for travel and outdoor activities.

How to use

To use mcp-openweather, obtain an OpenWeatherMap API key, clone the repository, build the service, and configure the environment variable with your API key. Then, integrate it into your MCP setup with the required parameters.

Key features

Key features include current weather conditions, a 5-day weather forecast, configurable units (Celsius/Fahrenheit/Kelvin), multi-language support, and simple MCP integration.

Where to use

mcp-openweather can be used in various fields such as web applications, mobile apps, and IoT devices that require weather data.

MCP Weather Service

A simple MCP service that provides current weather and 5-day forecast using the free OpenWeatherMap API.

Features

• Current weather conditions
• 5-day weather forecast
• Configurable units (Celsius/Fahrenheit/Kelvin)
• Multi-language support
• Simple MCP integration

Prerequisites

• Go 1.20+
• OpenWeatherMap API key

Installation

1. Get OpenWeatherMap API key from https://openweathermap.org/api

2. Clone repository:

   git clone https://github.com/mschneider82/mcp-openweather.git
   cd mcp-openweather
   

3. Build:

   go build -o mcp-weather
   

Installing via Smithery

To install MCP Weather Service for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mschneider82/mcp-openweather --client claude

Configuration

Set required environment variable:

export OWM_API_KEY="your_api_key_here"

Usage

MCP Parameters

Example Response

 Current weather for München:
     Conditions:  Klarer Himmel 
     Now:         17.78 metric
     High:        18.66 metric
     Low:         17.36 metric
     Pressure:    1017
     Humidity:    40
     FeelsLike:   16.66
     Wind Speed:  1.79
     Wind Degree:    61
     Sunrise:     1747107429 Unixtime
     Sunset:      1747161784 Unixtime
 Weather Forecast for München:
 Date & Time: 2025-05-13 12:00:00 +0000 UTC
 Conditions:  Clear Klarer Himmel
 Temp:        17.78 
 High:        18.93 
 Low:         17.78

 Date & Time: 2025-05-13 15:00:00 +0000 UTC
 Conditions:  Clear Klarer Himmel
 Temp:        18.33 
 High:        19.44 
 Low:         18.33

 Date & Time: 2025-05-13 18:00:00 +0000 UTC
 Conditions:  Clear Klarer Himmel
 Temp:        16.32 
 High:        16.32 
 Low:         15.59

 Date & Time: 2025-05-13 21:00:00 +0000 UTC
 Conditions:  Clear Klarer Himmel
 Temp:        9.18 
 High:        9.18 
 Low:         9.18
...

Error Handling

Common error scenarios:

Missing API key: FATAL: OWM_API_KEY environment variable not set

Invalid city: current weather error: failed to fetch current weather: city not found

Network issues: failed to fetch forecast: context deadline exceeded

Development

Contributions welcome! Please follow these steps:

Fork the repository

Create a feature branch

Commit changes

Push to the branch

Create a Pull Request

License

MIT License - see LICENSE for details