OpenWeather MCP Server

What is OpenWeather MCP Server?

A simple weather forecast MCP (Model Control Protocol) server that provides global weather forecasts and current weather conditions by integrating with the OpenWeatherMap API.

How to use OpenWeather MCP Server?

Install dependencies with pip install mcp-server requests pydantic, obtain a free API key from OpenWeatherMap, then run the server (python weather_mcp_server.py) providing the API key either as an environment variable (OPENWEATHER_API_KEY) or as a parameter when calling the tools. Add the server configuration to your MCP-enabled client.

Key features of OpenWeather MCP Server

• No separate configuration file required; API key via environment variable or parameter.
• Query weather conditions anywhere in the world.
• Provides both current weather and future forecast.
• Detailed info: temperature, humidity, wind speed, etc.
• Supports different time zones via an offset parameter.

Use cases of OpenWeather MCP Server

• Ask an AI assistant “What’s the weather in New York right now?” and receive current conditions.
• Get a multi‑day forecast for a travel destination.
• Integrate real‑time weather data into any MCP‑compatible application.

FAQ from OpenWeather MCP Server

What should I do if I see “No API key provided”?

Set the OPENWEATHER_API_KEY environment variable before starting the server, or provide the api_key parameter when calling get_weather or get_current_weather.

What causes a “Location not found” error?

The location name is incorrect or ambiguous. Try a more precise city name or add a country code, e.g., “Beijing,CN” or “Paris,FR”.

What are the runtime requirements?

Python 3 and the packages mcp-server, requests, and pydantic must be installed via pip.

How is the API key secured?

The key can be stored as an environment variable or passed at runtime; it is never hard‑coded in a configuration file.

Does the server support multiple transport methods?

The README only describes STDIO transport (running as a command‑line process with environment variables). No other transport is mentioned.