Turkish Weather Application

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

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:

export OPENWEATHER_TOKEN=your_openweather_token
# Windows PowerShell:
# $env:OPENWEATHER_TOKEN="your_openweather_token"

Run

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

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