MCP Weather Server

The MCP Weather Server is a comprehensive Model Context Protocol (MCP) compliant server designed to provide AI agents with access to real-time and historical weather data. Built using Python and FastAPI, it integrates with multiple weather APIs to deliver accurate, up-to-date meteorological information.

Key Features

• Model Context Protocol (MCP) compliance for seamless AI agent integration
• Multiple API integration: OpenMeteo, Tomorrow.io, Google Weather (via SerpApi), OpenWeatherMap, and AccuWeather.
• Comprehensive weather data: current conditions, forecasts, historical data, and alerts
• Robust error handling and data validation
• Configurable through environment variables
• Extensive logging and monitoring capabilities
• RESTful API design with JSON responses
• Built-in testing and validation tools

Installation & Setup

Prerequisites

• Python 3.8 or higher
• pip package manager
• Internet connection for API access
• Optional: Tomorrow.io API key for premium features

Installation Steps

1. Clone or download the project files
2. Install dependencies: pip install -r requirements.txt
3. Copy .env.example to .env
4. Configure environment variables (optional Tomorrow.io API key)
5. Run the server: python -m mcp_weather_server.server

Project Structure

mcp-weather-server/
├── src/mcp_weather_server/
│   ├── __init__.py
│   ├── server.py
│   ├── tools/
│   │   ├── __init__.py
│   │   ├── open_meteo.py
│   │   └── tomorrow_io.py
│   └── utils/
│       ├── __init__.py
│       └── weather_utils.py
├── requirements.txt
├── pyproject.toml
├── .env.example
├── README.md
├── test_server.py
└── examples.py