🇮🇱 Israel Weather MCP Server — Professional Documentation

ברוכים הבאים לפרויקט Israel Weather MCP Server! פרויקט זה הוא מימוש מתקדם של שרת Model Context Protocol (MCP) מקומי המשלב אוטומציה חכמה של דפדפן באמצעות Playwright, במטרה לספק למודיעין של מודלי שפה גדולים (LLMs) נתוני מזג אויר בזמן אמת ממקורות ישראליים.

🌟 תכונות עיקריות (Key Features)

• שרת MCP מותאם אישית (Custom MCP Server): השרת נבנה על גבי ה-SDK הרשמי ומגדיר פרוטוקול תקשורת סטנדרטי המאפשר למודל השפה לקרוא לפונקציות (Tools) ייעודיות באופן דינמי תוך כדי שיחה.

• אוטומציית דפדפן חכמה עם Playwright: במקום להסתמך על ממשקי API סטטיים או מוגבלים, המערכת מריצה דפדפן ברקע (Headless Mode), מנווטת באופן אוטומטי באתרים ייעודיים למזג אויר בישראל, מזינה את שם העיר בשורת החיפוש, בוחרת את התוצאה מהתפריט הנפתח ושולפת את המידע המדויק.

• מארח צ'אט טרמינל אינטראקטיבי (host.py): סביבת עבודה המקשרת בין מודל השפה המקומי לבין כלים חיצוניים. הטרמינל מאפשר ניהול שיחה רציפה שבה המודל מחליט בעצמו מתי להפעיל את כלי חיפוש מזג האוויר כדי לענות לשאלה.

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

🛠️ כלים זמינים במערכת (Available Tools)

המערכת חושפת בפני המודל כלים ייעודיים המופעלים אוטומטית לפי הצורך:

• כלי חיפוש מזג אוויר מקומי: מקבל שם של עיר בישראל (לדוגמה: ירושלים, תל אביב, חיפה), מפעיל את הדפדפן מאחורי הקלעים, שואב את נתוני התחזית המעודכנים מאתרים מובילים, ומחזיר אותם כטקסט מובנה למודל.

💻 סטאק טכנולוגי (Tech Stack)

• Python: שפת הבסיס לפיתוח הלוגיקה, ניהול השרת והאינטגרציות.

• Anthropic MCP SDK: המסגרת הטכנולוגית המאפשרת את ניהול הפרוטוקול והכלים מול ה-LLM.

• Playwright for Python: ספריית אוטומציה עוצמתית לשליטה מלאה בדפדפן Chromium.

• UV Package Manager: כלי מהיר ומודרני לניהול תלויות וסביבות עבודה בפייתון.

📂 מבנה תיקיות וקבצים בפרויקט

weather-chat_mcp/
├── client.py            # קליינט MCP בסיסי לבדיקת תקשורת ישירה מול השרת
├── host.py              # סקריפט ראשי להרצת הצ'אט האינטראקטיבי בטרמינל
├── weather_Israel.py    # שרת ה-MCP הייעודי לישראל המשלב אוטומציה של Playwright
├── weather_USA.py       # שרת ייחוס המדגים עבודה מול API חיצוני בארה"ב
├── pyproject.toml       # קובץ הקונפיגורציה והגדרת התלויות של הפרויקט
├── uv.lock              # קובץ נעילת גרסאות להבטחת סביבת עבודה יציבה
└── .gitignore           # מניעת העלאת קבצים רגישים (כגון .env וסביבות וירטואליות)