שרת MCP למזג אוויר בישראל (Playwright & Gemini) 🌦️🤖

מימוש של שרת מבוסס פרוטוקול הקשר למודלים (MCP - Model Context Protocol) המעניק למודל שפה גדול (LLM) יכולות שליטה אוטומטיות בדפדפן (Browser Use). הפרויקט משתמש בספריית Playwright כדי לנונווט, לבצע אינטראקציה ולשלוף נתוני מזג אוויר בזמן אמת מאתר התחזית הישראלי, תוך ביצוע לולאת RAG (Retrieval-Augmented Generation) מלאה ואוטונומית ישירות בתוך הטרמינל.

🎯 מטרות הפרויקט ויעדי למידה

• ארכיטקטורת MCP: בנייה וחשיפה של כלים (Tools) מותאמים אישית ל-LLM באמצעות ה-SDK הרשמי של Anthropic.

• אוטומציית דפדפן: שימוש ב-Microsoft Playwright לצורך שליטה תוכנתית בדפדפן Chromium, תוך עקיפת המגבלות של גירוד מידע (Scraping) סטטי רגיל.

• סוכן RAG מבוסס פעולה (Agentic Flow): מתן אפשרות ל-LLM לנהל בעצמו ובאופן אוטומטי מספר שלבים בדפדפן בזה אחר זה (פתיחה ➔ חימוש ➔ בחירה ➔ חילוץ מידע) ולהשיב למשתמש על בסיס התוכן הדינמי של העמוד.

Related MCP server: Israel Weather AI Agent

🧩 ארכיטקטורה ועיצוב טכנולוגי

בניגוד למימושים פשוטים של Scraping, פרויקט זה מבטיח יציבות גבוהה ושמירה על מצב הדפדפן (State) באמצעות:

1. ניהול State גלובלי בשרת: מופע הדפדפן והעמוד (browser ו-page) מנוהלים כמשתנים גלובליים בתוך הקובץ weather_Israel.py. השרת שומר על דפדפן פעיל אחד לאורך כל סבבי הקריאות של הכלים, במקום לפתוח ולסגור אותו מחדש בכל פעם. הדבר חוסך במשאבים ושומר על הקשר השיחה.

2. סנכרון חסין (Robust Synchronization): שימוש בזמני המתנה אסינכרוניים מפורשים (wait_for_selector ו-wait_for_load_state("networkidle")) כדי להבטיח שרשימות נפתחות (Dropdown) ומעברי דפים נטענים לחלוטין לפני שהסוכן מנסה ללחוץ או לקרוא מהם, מה שמונע קריסות בשמות ערים מורכבים.

3. אופטימיזציית טוקנים (RAG נקי): במקום להעביר את כל קוד ה-HTML הגולמי והרועש של העמוד לתוך הקונטקסט של המודל, כלי השליפה מטרגט סלקטורים ספציפיים (CSS Selectors) המכילים את נתוני התחזית בלבד ומסנן רעשי רקע עיצוביים.

🛠️ סטאק טכנולוגי

• MCP SDK: שכבת הפרוטוקול הרשמית של Anthropic לחיבור הכלים למודל.

• Playwright: ספריית האוטומציה המודרנית של Microsoft לשליטה בדפדפנים.

• UV: מנהל החבילות המהיר לפייתון לצורך התקנה וסנכרון סביבת העבודה.

• Gemini 2.5 Flash: מודל השפה המרכזי המנהל את לולאת קבלת ההחלטות והפעלת הכלים.

🚀 התקנה והרצה

עקבי אחר השלבים הבאים כדי להרים את הסביבה ולהריץ את הפרויקט באופן מקומי:

1. סנכרון התלויות והפעלת סביבת העבודה:

   uv sync
   התקנת דפדפן כרום (Chromium) עבור Playwright:

Bash uv run playwright install chromium הרצת צ'אט הטרמינל (ה-Client):

Bash uv run host.py 💻 דוגמת שימוש והרצה בזמן אמת לאחר הפעלת ה-Client, ניתן לשוחח עם הסוכן בשפה חופשית בעברית. המודל יחליט בעצמו באילו כלים להשתמש, יבצע את הפעולות בדפדפן הפתוח (הנפתח במצב נראה לעין - headless=False), ויציג את התחזית הסופית בטרמינל.

לוג הרצה מוצלח מהטרמינל (עבור ירושלים): Plaintext Query: מה המזג אוויר בירושלים? Connected to server with tools: ['open_weather_forecast_israel', 'enter_weather_forecast_city_israel', 'select_weather_forecast_city_israel', 'get_page_content_israel']

🤖 גמיני חושב... (סיבוב 1/5) 📞 המודל מפעיל את הכלי: weather_Israel__open_weather_forecast_israel עם הפרמטרים: {}

🤖 גמיני חושב... (סיבוב 2/5) 📞 המודל מפעיל את הכלי: weather_Israel__enter_weather_forecast_city_israel עם הפרמטרים: {'city_name': 'ירושלים'}

🤖 גמיני חושב... (סיבוב 3/5) 📞 המודל מפעיל את הכלי: weather_Israel__select_weather_forecast_city_israel עם הפרמטרים: {}

🤖 גמיני חושב... (סיבוב 4/5) 📞 המודל מפעיל את הכלי: weather_Israel__get_page_content_israel עם הפרמטרים: {}

🤖 גמיני חושב... (סיבוב 5/5)

[Calling tool weather_Israel__open_weather_forecast_israel] [Calling tool weather_Israel__enter_weather_forecast_city_israel] [Calling tool weather_Israel__select_weather_forecast_city_israel] [Calling tool weather_Israel__get_page_content_israel]

הטמפרטורה הנוכחית בירושלים היא 30.2 מעלות צלזיוס.

תחזית להיום: לאחר התפזרות עננות הבוקר, ייעשה בהיר. הטמפרטורות יוסיפו להיות מעט גבוהות מהרגיל לעונה, בעיקר בהרים ובפנים הארץ.

הלילה: מעונן חלקית עד בהיר.

תחזית לימים הקרובים:

• רביעי: לאחר התפזרות עננות הבוקר, ייעשה נאה. תחול ירידה קלה בטמפרטורות בהרים ובפנים הארץ.

• חמישי: לאחר התפזרות עננות הבוקר, ייעשה נאה. לא צפוי שינוי ניכר בטמפרטורות.