🌤️ — תחזית מזג אוויר בישראל

פרויקט לימוד בפיתוח MCP (Model Context Protocol): סוכן (Agent) מבוסס LLM שיודע לשלוף תחזית מזג אוויר לערים בישראל ובארה"ב, ולענות עליה בשפה חופשית בצ'אט שבטרמינל.

---

🎯 מטרת הפרויקט

לבנות שרת MCP ייעודי ש"מלמד" את ה-LLM לבצע משימה שהוא לא יודע לבד — לשלוף תחזית מזג אוויר מאתר ישראלי שאין לו API.

הסוכן עושה זאת בשתי דרכים:

1. שרת ישראל (weather-Israel) — מאטמט דפדפן אמיתי עם Playwright: פותח את weather2day.co.il/forecast, מחפש עיר, בוחר אותה, ואז מחלץ את תוכן דף התחזית ומזין אותו ל-LLM כדי שיענה בעצמו (גישת RAG).
2. שרת ארה"ב (weather-USA) — שולף תחזית והתרעות דרך ה-API הרשמי של ה-NWS (National Weather Service).

ה-Host מחבר את כל השרתים ל-LLM (Gemini, דרך ה-API התואם-OpenAI), אוסף מהם אוטומטית את כל ה-Tools, ומריץ לולאת צ'אט שבה ה-LLM בוחר באיזה כלי להשתמש ומפעיל אותם בזה אחר זה עד שמתקבלת תשובה.

---

🏗️ מבנה הפרויקט

project-template/
├── host.py            # צ'אט בטרמינל שמחבר את ה-LLM לכל שרתי ה-MCP
├── client.py          # MCP Client גנרי (מתחבר לשרת, מריץ Tools)
├── weather_USA.py     # שרת MCP לארה"ב — דרך NWS API
├── weather_Israel.py  # שרת MCP לישראל — דרך אטמוט דפדפן (Playwright)
├── pyproject.toml     # תלויות הפרויקט
└── README.md

ה-Tools של שרת ישראל

#	Tool	תפקיד
1	open_weather_forecast_israel	פותח דפדפן Chromium ומנווט לאתר התחזית
2	enter_weather_forecast_city_israel	מקליד שם עיר בשדה החיפוש
3	select_weather_forecast_city_israel	בוחר את העיר הראשונה מרשימת ההצעות
4	get_weather_forecast_content_israel	מחלץ את תוכן דף התחזית (כולל iframes) ומחזיר אותו ל-LLM

💡 שלושת הראשונים חולקים אותו דפדפן דרך מצב גלובלי (_page), כי כולם רצים באותו תהליך-שרת. הרביעי עובר על כל ה-frames בדף, כי התחזית עצמה נטענת בתוך <iframe> שה-body הראשי לא רואה.

---

⚙️ התקנה והרצה

דרישות מקדימות

• Python ≥ 3.13
• uv (מנהל הסביבה והתלויות)
• מפתח API ל-Gemini (קבלת מפתח חינמי)

שלבים

# 1. התקנת התלויות והקמת סביבת העבודה
uv sync

# 2. התקנת דפדפן Chromium עבור Playwright
uv run playwright install chromium

הגדרת משתני סביבה

צרו קובץ .env בתיקיית הפרויקט:

GEMINI_API_KEY=your_api_key_here
GEMINI_MODEL=gemini-2.0-flash

הרצה

uv run host.py

לאחר ההפעלה תופיע שורת Query: — הקלידו שאלה (או quit ליציאה).

---

💬 דוגמאות לשאלות שהסוכן יודע לענות עליהן

תחזית בישראל (Playwright)

נפתח חלון דפדפן שבו רואים את דף התחזית, וה-LLM גם עונה בצ'אט.

• "מה התחזית בתל אביב?"
• "כמה מעלות צפויות מחר בירושלים?"
• "איך מזג האוויר בחיפה היום?"
• "תפתחי לי את התחזית לבאר שבע"

תחזית והתרעות בארה"ב (NWS API)

• "What's the weather forecast for San Francisco?" (latitude/longitude)
• "Are there any weather alerts in California?"
• "Show me active weather alerts for NY"

---

🧩 איך זה עובד (תרשים זרימה)

משתמש → "מה התחזית בתל אביב?"
   │
   ▼
 Host  ──►  LLM (Gemini) בוחר Tools להפעיל
   │
   ▼  (שרת ישראל, בזה אחר זה)
 open → enter("תל אביב") → select → get_content
   │
   ▼
 תוכן התחזית חוזר ל-LLM (RAG)
   │
   ▼
 LLM כותב תשובה בשפה חופשית בצ'אט ✨

---

📝 הערות

• ה-LLM הוא זה שמחליט אילו Tools להפעיל ובאיזה סדר — לא כתבנו לוגיקה קשיחה.
• שני קבצי שרת = שני תהליכים נפרדים, ולכן כל מצב משותף (כמו הדפדפן הפתוח) חי בתוך שרת אחד בלבד.