GitHub - mschneider82/mcp-openweather: mcp server for openweather free api (original) (raw)

MCP Weather Service

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

Features

Prerequisites

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:

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

"mcpServers": { "mcp-openweather": { "command": "/home/YOURUSER/git/mcp-openweather/mcp-openweather", "env": { "OWM_API_KEY": "PUT_API_KEY_HERE" } } }

MCP Parameters

{ "tool": "weather", "params": { "city": "Berlin", // Required "units": "c", // Optional (c|f|k) "lang": "en" // Optional (en|de|fr|...) } }

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