English |
A simple weather forecast MCP (Model Control Protocol) server providing global weather forecasts and current weather conditions.
Screenshot of Claude Desktop using the MCP Weather Service
- No separate configuration file needed; API key can be passed directly through environment variables or parameters
- Support for querying weather conditions anywhere in the world
- Provides current weather and future forecasts
- Detailed weather information including temperature, humidity, wind speed, etc.
- Support for different time zones
pip install mcp-server requests pydantic
Visit OpenWeatherMap and register an account to obtain an API key.
There are two ways to provide the API key:
# Set environment variables
export OPENWEATHER_API_KEY="your_api_key" # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key # Windows
# Run the server
python weather_mcp_server.pyRun directly without setting environment variables:
python weather_mcp_server.pyWhen calling the tool, you'll need to provide the api_key parameter.
Add the following configuration to your 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"]
}
}Get current weather and forecast for a specified location.
Parameters:
location: Location name, e.g., "Beijing", "New York", "Tokyo"api_key: OpenWeatherMap API key (optional, will read from environment variable if not provided)timezone_offset: Timezone offset in hours, e.g., 8 for Beijing, -4 for New York. Default is 0 (UTC time)
Get current weather for a specified location.
Parameters:
location: Location name, e.g., "Beijing", "New York", "Tokyo"api_key: OpenWeatherMap API key (optional, will read from environment variable if not provided)timezone_offset: Timezone offset in hours, e.g., 8 for Beijing, -4 for New York. Default is 0 (UTC time)
AI assistant call example:
User: What's the weather like in New York right now?
AI: Let me check the current weather in New York for you.
[Calling get_current_weather("New York", timezone_offset=-4)]
Current weather in New York: 18°C, partly cloudy, humidity 65%, wind speed 3.5m/s.
If you encounter a "No API key provided" error, make sure:
- You have set the OPENWEATHER_API_KEY in environment variables, or
- You are providing the api_key parameter when calling the tools
If the location name is incorrect, you might receive a "Location not found" error. Try using a more accurate city name or add a country code, e.g., "Beijing,CN" or "Paris,FR".