Turkish Weather Application
- other
About
What is Turkish Weather Application?
Turkish Weather Application is an MCP (Model Context Protocol) server that provides real-time weather data, forecasts, and air quality information for cities in Turkey. It is designed to be used with any MCP-compatible client such as Copilot, ChatGPT, or other language models that support the protocol. The application targets developers and users who need Turkish weather data integrated into AI workflows.
How to use Turkish Weather Application?
Install Python 3.11+, run pip install httpx mcp, obtain an OpenWeatherMap API key and set it in config.py, then start the server with python weather.py. Once running, any MCP client can call the provided tools (e.g., hava_durumu_sehir) to fetch weather data.
Key features of Turkish Weather Application
- Current weather conditions for Turkish cities
- Hourly weather forecasts
- Air quality index (AQI) data
- Cross‑city weather comparison
- Activity recommendations based on weather
- Weather alerts and notifications
Use cases of Turkish Weather Application
- Ask a language model for today’s weather in Istanbul
- Compare hourly forecasts between Ankara and İzmir
- Get air quality warnings before planning outdoor events
- Receive activity suggestions like “good day for a walk” based on conditions
FAQ from Turkish Weather Application
What is MCP and how does this application use it?
MCP (Model Context Protocol) is an open standard that enables communication between language models and external tools. This application acts as an MCP server, allowing any MCP‑compatible client to call its weather tools.
Do I need an API key to use this application?
Yes, you must obtain a free or paid API key from OpenWeatherMap (https://openweathermap.org/api) and set it in the config.py file before starting the server.
Which cities are supported?
The application supports cities in Turkey; a predefined list is stored in config.py. Additional cities can be added by modifying that file, though the README does not specify any built‑in coverage limits.
What is the licensing for this application?
It is released under the MIT license, allowing free use, modification, and distribution.
Are there any known usage limits or costs?
The README does not mention any usage limits or costs beyond the optional OpenWeatherMap API key pricing. No built‑in rate limiting is documented.
Details
- Author
- emredeveloper
- GitHub stars
- 1
- Category
- other
- Repository
- emredeveloper/mcp-turkey-weather
Turkish Weather Application
Bu uygulama, Türkiye'deki şehirler için hava durumu bilgilerini sağlayan bir MCP (Model Context Protocol) aracıdır.
Özellikler
- Türkiye'deki şehirler için güncel hava durumu
- Saatlik hava durumu tahminleri
- Hava kalitesi bilgileri
- Şehirler arası hava karşılaştırması
- Hava durumuna göre aktivite önerileri
- Hava durumu alarmları
Kurulum
1. Python 3.11 veya üstünü yükleyin
2. Gerekli paketleri yükleyin: pip install httpx mcp
3. OpenWeatherMap API anahtarı alın (https://openweathermap.org/api) ve config.py dosyasında ayarlayın
Kullanım
Uygulamayı başlatmak için:
python weather.py
MCP İstemcisi ile Kullanım
Bu uygulama bir MCP (Model Context Protocol) sunucusu olarak çalışır. MCP, dil modelleri ile araçlar arasında iletişim sağlayan açık bir protokoldür.
1. Uygulamayı başlattıktan sonra, bir MCP istemcisi (örneğin Copilot, ChatGPT veya başka bir MCP destekli dil modeli) kullanarak komutlar gönderebilirsiniz.
2. İstemci üzerinden şu formatta araçları çağırabilirsiniz:
Araçlar
- hava_durumu_sehir: Belirli bir şehir için hava durumu bilgisi
- saatlik_hava_durumu: Saatlik hava durumu tahminleri
- hava_kalitesi: Hava kalitesi endeksi bilgileri
- sehirler_karsilastir: İki şehri karşılaştırma
- havadurumu_aktivite_onerileri: Hava durumuna göre aktivite önerileri
Proje Yapısı
- weather.py: Ana uygulama ve MCP araçları
- api.py: API istekleri için yardımcı fonksiyonlar
- utils.py: Yardımcı fonksiyonlar
- config.py: Yapılandırma sabitler ve şehir verileri
Lisans
MIT
