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
- Clone or download the project files
- Install dependencies:
pip install -r requirements.txt - Copy
.env.exampleto.env - Configure environment variables (optional Tomorrow.io API key)
- 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