Weather MCP Server 🌤️

A Model Context Protocol (MCP) server that provides weather information tools. This server enables AI assistants like Claude to fetch real-time weather data, forecasts, and compare weather across different cities.

Features

• Current Weather: Get real-time weather information for any city
• Weather Forecast: Get weather predictions for up to 10 days (based on API plan)
• Weather Comparison: Compare weather conditions between two cities
• Supports both Celsius (metric) and Fahrenheit (imperial) units

Prerequisites

• Python 3.8 or higher
• WeatherAPI.com API key (free tier available)

Installation

1. Clone the repository

   git clone https://github.com/Abhishek3689/Weather_MCP_Server.git
   cd weather-mcp-server
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Set up environment variables

   Create a .env file in the project root:

   WEATHER_API_KEY=your_api_key_here
   

   Get your free API key from WeatherAPI.com

Usage

🚀 Running The Server (Important!) 👉 If you double-click or run the file, you will NOT see results.

MCP servers do not show output directly.

They wait for Claude to connect to them.

But you can still start the server manually to ensure it’s working:

python weather_server_mcp.py

You would see somthing like this it means server is running correclty

          ╭──────────────────────────────────────────────────────────────────────────────╮
          │                                                                              │
          │                         ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█                        │
          │                         █▀  █▀█ ▄▄█  █  █ ▀ █ █▄▄ █▀▀                        │
          │                                                                              │
          │                                FastMCP 2.13.1                                │
          │                                                                              │
          │                                                                              │
          │                    🖥  Server name: Weather Server                            │
          │                                                                              │
          │                    📦 Transport:   STDIO                                     │
          │                                                                              │
          │                    📚 Docs:        https://gofastmcp.com                     │
          │                    🚀 Hosting:     https://fastmcp.cloud                     │
          │                                                                              │
          ╰──────────────────────────────────────────────────────────────────────────────╯

          

Integration with Claude Desktop

To use this server with Claude Desktop, add the following to your Claude Desktop configuration:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": [
        "weather_server_mcp.py"
      ],
      "env": {
        "WEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Note : for 'command' write absolute location instead of only "python" by checking using in command prompt

where python

you will see somthing like this

C:\Users\YourName\AppData\Local\Programs\Python\Python312\python.exe

After updating the config, restart Claude Desktop.

Available Tools

1. Get Current Weather

get_current_weather(city: str, units: str = "metric")

• city: City name (e.g., 'London', 'New York', 'Tokyo')
• units: 'metric' for Celsius or 'imperial' for Fahrenheit

Example:

get_current_weather("London", "metric")

2. Get Weather Forecast

get_forecast(city: str, days: int = 3, units: str = "metric")

• city: City name
• days: Number of forecast days (1-10)
• units: Temperature units

Example:

get_forecast("Paris", days=5, units="metric")

3. Compare Weather

compare_weather(city1: str, city2: str, units: str = "metric")

• city1: First city name
• city2: Second city name
• units: Temperature units

Example:

compare_weather("Tokyo", "New York", "metric")

Project Structure

weather-mcp-server/
├── weather_server_mcp.py   # Main MCP server implementation
├── requirements.txt        # Python dependencies
├── .env                    # Environment variables (not committed)
├── .gitignore             # Git ignore file
└── README.md              # This file

API Information

This project uses the WeatherAPI.com service:

• Free tier: 1,000,000 calls/month
• 3-day forecast on free plan
• Real-time weather data
• Historical weather data

Example Output

Current Weather in London, United Kingdom

📍 Location: 51.52, -0.11
🌡️  Temperature: 15°C
🤔 Feels Like: 14°C
☁️  Condition: Partly cloudy
💧 Humidity: 72%
🔽 Pressure: 1013.0 hPa
💨 Wind Speed: 15.1 kph
☁️  Cloudiness: 25%
👁️  Visibility: 10.0 km

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Troubleshooting

"WEATHER_API_KEY environment variable not set"

• Make sure you've created a .env file with your API key
• Or set the environment variable in your system/Claude config

"HTTP Error: 401"

• Check that your API key is valid
• Ensure the API key is correctly set in your .env file

"Only X days available"

• Free tier of WeatherAPI.com provides 3-day forecasts
• Upgrade to a paid plan for extended forecasts

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Check the WeatherAPI.com documentation
• Review the MCP documentation

Author

Project Link: https://github.com/Abhishek3689/Weather_MCP_Server

Acknowledgments

• FastMCP - Framework for building MCP servers
• WeatherAPI.com - Weather data provider
• Anthropic - Claude AI and MCP protocol