MCP-Turkey-Weather

# Turkish Weather MCP Server A Model Context Protocol (MCP) server that provides weather tools for major cities in Türkiye. ## Features - Current weather by city - Hourly weather forecasts - Air quality information - City-to-city weather comparison - Activity suggestions based on weather conditions - Weather alert style responses ## Requirements - Python 3.11+ - OpenWeather access token ## Setup ```bash git clone https://github.com/emredeveloper/MCP-Turkey-Weather.git cd MCP-Turkey-Weather python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install httpx mcp ``` Set your token as an environment variable: ```bash export OPENWEATHER_TOKEN=your_openweather_token # Windows PowerShell: # $env:OPENWEATHER_TOKEN="your_openweather_token" ``` ## Run ```bash python weather.py ``` ## MCP Tools - `hava_durumu_sehir`: Get current weather for a Turkish city - `saatlik_hava_durumu`: Get hourly forecast - `hava_kalitesi`: Get air quality index information - `sehirler_karsilastir`: Compare weather between two cities - `havadurumu_aktivite_onerileri`: Suggest activities based on weather ## Project Structure ```text MCP-Turkey-Weather/ ├── weather.py # MCP server and tool definitions ├── api.py # OpenWeather API helpers ├── utils.py # Formatting and utility helpers ├── config.py # Configuration and supported cities └── README.md ``` ## Notes - Do not commit real tokens to the repository. - The server reads `OPENWEATHER_TOKEN` from the environment. - City names are normalized through the supported city dictionary in `config.py`. ## License MIT