Openweather MCP Server

🚀 OpenWeather MCP Server

A simple weather forecast MCP (Model Control Protocol) server that provides global weather forecasts and current weather conditions.

📷 Screenshot of Claude Desktop Using MCP Weather Service

✨ Features

• No separate configuration file is required; the API key can be passed directly via environment variables or parameters.
• Supports weather queries for any location worldwide.
• Provides current weather and future forecasts.
• Offers detailed weather information, including temperature, humidity, wind speed, etc.
• Supports different time zones.

📦 Installation

pip install mcp-server requests pydantic

💻 Usage Examples

1. Obtain an OpenWeatherMap API Key

Visit OpenWeatherMap to register an account and obtain an API key.

2. Run the Server

There are two ways to provide the API key:

Method 1: Use Environment Variables

# Set the environment variable
export OPENWEATHER_API_KEY="your_api_key"  # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key  # Windows

# Start the server
python weather_mcp_server.py

Method 2: Provide at Runtime

Run directly without setting environment variables:

python weather_mcp_server.py

When calling the tool, you need to provide the api_key parameter.

3. Use in MCP Client Configuration

Add the following configuration to an MCP-supported client:

{
  "weather_forecast": {
    "command": "python",
    "args": [
      "/full_path/weather_mcp_server.py"
    ],
    "env": {
      "OPENWEATHER_API_KEY": "your_openweathermap_key_here"
    },
    "disabled": false,
    "autoApprove": ["get_weather", "get_current_weather"]
  }
}

4. Available Tools

get_weather

Get the current weather and forecast for a specified location.

Parameters:

• location: Location name, e.g., "Beijing", "New York", "Tokyo".
• api_key: OpenWeatherMap API key (optional, read from environment variables by default).
• timezone_offset: Time zone offset (in hours), e.g., 8 for Beijing, -4 for New York. Default is 0 (UTC time).

get_current_weather

Get the current weather for a specified location.

Parameters:

• location: Location name, e.g., "Beijing", "New York", "Tokyo".
• api_key: OpenWeatherMap API key (optional, read from environment variables by default).
• timezone_offset: Time zone offset (in hours), e.g., 8 for Beijing, -4 for New York. Default is 0 (UTC time).

Basic Usage

AI assistant call example:

User: What's the current weather in New York?

AI: Let me check the current weather in New York for you.
[Call get_current_weather("New York", timezone_offset=-4)]

The current weather in New York: 18°C, cloudy, humidity 65%, wind speed 3.5m/s.

🛠️ Troubleshooting

If you encounter an error saying "API key not provided", make sure:

1. You have set the OPENWEATHER_API_KEY in the environment variables, or
2. You have provided the api_key parameter when calling the tool.

If the location name is incorrect, you may receive an error saying "Location not found". Try using a more accurate city name or adding the country code, e.g., "Beijing,CN" or "Paris,FR".