🌤️ — イスラエルの天気予報

**MCP（Model Context Protocol）**開発の学習プロジェクト：イスラエルと米国の都市の天気予報を取得し、ターミナルのチャットで自由な言語で回答できるLLMベースのエージェント（Agent）。

🎯 プロジェクトの目的

LLMが単独ではできないタスク——APIを持たないイスラエルのサイトから天気予報を取得すること——を「教える」専用のMCPサーバーを構築します。

エージェントはこれを2つの方法で行います：

1. イスラエルサーバー（weather-Israel） — Playwrightで実際のブラウザを自動操作します：weather2day.co.il/forecastを開き、都市を検索して選択し、予報ページのコンテンツを抽出してLLMに供給し、LLM自身が回答します（RAGアプローチ）。

2. 米国サーバー（weather-USA） — NWS（National Weather Service）の公式APIを通じて予報と警報を取得します。

HostはすべてのサーバーをLLM（Gemini、OpenAI互換API経由）に接続し、サーバーからすべてのToolsを自動的に収集し、LLMがどのツールを使用するかを選択して、回答が得られるまでそれらを次々に実行するチャットループを実行します。

Related MCP server: mcp-playwright-weather-israel

🏗️ プロジェクト構造

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

💡 最初の3つは、すべて同じサーバープロセスで実行されるため、グローバル状態（_page）を介して同じブラウザを共有します。4つ目は、予報自体がメインのbodyからは見えない<iframe>内に読み込まれるため、ページ上のすべてのframesを調べます。

⚙️ インストールと実行

前提条件

• Python ≥ 3.13

• uv（環境と依存関係のマネージャー）

• Gemini用のAPIキー（無料キーを取得）

手順

# 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を実行するか、どの順序で実行するかを決定します — ハードコードされたロジックは書いていません。

• サーバーファイルが2つ = 別々のプロセスが2つ。したがって、共有状態（開いているブラウザなど）は1つのサーバー内にのみ存在します。