A
securityA
licenseA
qualityAn MCP server that provides real-time weather information including temperature, humidity, wind speed, and sunrise/sunset times through the OpenWeatherMap API.
Last updated -
1
2
MIT License
Used for storing API credentials securely in a .env file for the OpenWeatherMap API integration
Required as the runtime environment (version 3.10+) for executing the MCP server
Weather MCP Tool (India-Focused)
An MCP (Model Context Protocol) server using the OpenWeatherMap API to provide:
Real-time weather conditions
5-day weather forecasts
Air quality data
Location search
🚀 Setup
Python 3.10+ is required.
Install dependencies:
pip install -r requirements.txtGet an API key from OpenWeatherMap.
Create a in the root folder:
OPENWEATHER_API_KEY=your_api_key_here
🛠 Available Tools
get_current_weather(location: str)
Returns current weather for a given location.
get_weather_forecast(location: str, days: int = 5)
Returns a weather forecast (up to 5 days) for the location.
get_air_quality(location: str)
Returns air quality metrics and AQI level.
search_location(query: str)
Returns up to 5 location matches based on the query.
🧪 Example Output (India)
Current Weather (Delhi)
{
"location": {
"name": "Delhi",
"country": "IN",
"lat": 28.6139,
"lon": 77.2090
},
"temperature": {
"current": 32.4,
"feels_like": 35.1,
"min": 30.0,
"max": 36.2
},
"weather_condition": {
"main": "Haze",
"description": "smoky haze",
"icon": "50d"
},
"wind": {
"speed": 4.1,
"deg": 135
},
"clouds": 20,
"humidity": 58,
"pressure": 1005,
"visibility": 5000,
"sunrise": "2025-03-16T06:20:00",
"sunset": "2025-03-16T18:40:00",
"timestamp": "2025-03-16T14:30:00"
}
Weather Forecast (Mumbai)
{
"location": {
"name": "Mumbai",
"country": "IN",
"lat": 19.0760,
"lon": 72.8777
},
"forecast": [
{
"datetime": "2025-03-16T12:00:00",
"temperature": {
"temp": 33.2,
"feels_like": 37.8,
"min": 31.5,
"max": 34.0
},
"weather_condition": {
"main": "Clouds",
"description": "scattered clouds",
"icon": "03d"
},
"wind": {
"speed": 3.9,
"deg": 200
},
"clouds": 40,
"humidity": 70,
"pressure": 1008,
"visibility": 10000,
"pop": 0.1
}
],
"days": 5
}
Air Quality (Bangalore)
{
"location": {
"name": "Bengaluru",
"country": "IN",
"lat": 12.9716,
"lon": 77.5946
},
"air_quality_index": 2,
"air_quality_level": "Fair",
"components": {
"co": 102.4,
"no": 0.0,
"no2": 12.6,
"o3": 30.5,
"so2": 3.8,
"pm2_5": 45.1,
"pm10": 60.2,
"nh3": 1.5
},
"timestamp": "2025-03-16T14:30:00"
}
Location Search
{
"results": [
{
"name": "Kolkata",
"state": "West Bengal",
"country": "IN",
"lat": 22.5726,
"lon": 88.3639
},
{
"name": "Kolkata",
"state": "",
"country": "IN",
"lat": 22.5675,
"lon": 88.3700
}
]
}
🧰 Error Handling
All tools return clear error messages:
{ "error": "Location 'XYZ' not found" }
📌 Notes
Ensure
.envfile is configured correctly.API keys may take time to activate.
OpenWeatherMap free tier: 60 API calls per minute.
🧑💻 Run the Server
mcp dev main.py
Once running, you can use this server with MCP-compatible clients like Claude Desktop or other automation tools.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An India-focused MCP server that provides real-time weather conditions, forecasts, air quality data, and location search capabilities using the OpenWeatherMap API.
Related MCP Servers
- -securityFlicense-qualityAn MCP server implementation that allows users to fetch and display weather information for specified cities, including temperature, humidity, wind speed, and weather descriptions.Last updated -1
- -securityAlicense-qualityAn MCP server that connects to OpenWeatherMap's API to provide current weather data and multi-day forecasts for locations worldwide in different measurement units.Last updated -3MIT License
- -securityFlicense-qualityAn MCP server that provides weather information like forecasts and alerts for US locations using the National Weather Service API.Last updated -4