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

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

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

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

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

שרת ישראל (weather-Israel) — מאטמט דפדפן אמיתי עם Playwright: פותח את weather2day.co.il/forecast, מחפש עיר, בוחר אותה, ואז מחלץ את תוכן דף התחזית ומזין אותו ל-LLM כדי שיענה בעצמו (גישת RAG).
שרת ארה"ב (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 להפעיל ובאיזה סדר — לא כתבנו לוגיקה קשיחה.
שני קבצי שרת = שני תהליכים נפרדים, ולכן כל מצב משותף (כמו הדפדפן הפתוח) חי בתוך שרת אחד בלבד.