MCP with Playwright - 天気 (イスラエル)

このプロジェクトは、Malka Baruch のコース「MCP with Playwright」の MCP (Model Context Protocol) 課題です。

プロジェクトの目的

MCP サーバーは、Playwright を使用して実際のブラウザを操作し、https://www.weather2day.co.il/forecast からデータをスクレイピングすることで、イスラエルの都市の天気予報を提供します。目的は、LLM（Claude）が公開された Tools を通じてブラウザを制御し、従来の API なしでライブの Web データを取得できるようにすることです。

Related MCP server: MCP Playwright Weather Israel

実装した内容

Tools（MCP サーバー - weather_Israel.py）:

1. open_weather_forecast_israel()

   • Chromium ブラウザを（headless=False で）起動し、天気予報サイトに移動します。ブラウザと Page インスタンスをグローバルコンテキストに保持し、Tool 呼び出し間で永続化します。

2. enter_weather_search_israel(city: str)

   • 指定された都市名をサイトの検索フィールドに入力し、オートコンプリートリストが表示されるのを待ちます。

3. select_weather_forecast_city_israel()

   • 最初のオートコンプリート結果を選択（または Enter キーを押下）し、予報ページが読み込まれるのを待ちます。

4. extract_weather_data_israel()

   • 読み込まれたページから表示されている予報テキストを抽出し、広告や UI ノイズを除去してクリーンアップします。これにより、LLM は有用な天気データのみを受け取ります。

実行方法

1. project-template フォルダから:

cd C:\Users\user1\Downloads\dovrot-ai-projects-master\dovrot-ai-projects-master\8-mcp\project-template
uv sync
uv run playwright install chromium

2. ホスト（ターミナルチャットインターフェース）を起動:

uv run host.py

3. ホストのチャットプロンプトで、次のような質問をします:

• 「מה התחזית בתל אביב היום?」

• 「תן חיזוי גשם בתל אביב מחר」

ホストはリクエストを weather-Israel MCP にルーティングし、LLM が Tools を順番に（開く→入力→選択→抽出）呼び出して予報を取得し、返します。

提出手順

• リポジトリを公開の GitHub リポジトリとしてプッシュしてください。

• この README.md に目的と実行手順を記載してください。

• .env には実際の API キーをコミットしないでください。.env.example をプレースホルダーとともに使用してください。

注意事項とトラブルシューティング

• Anthropic SDK（Claude）で実行する場合は、環境変数 ANTHROPIC_API_KEY が設定されていることを確認してください。

• Playwright のセレクターが機能しなくなった場合（サイト変更）、weather_Israel.py 内のセレクターをサイトの HTML（DevTools で検査）に合わせて更新してください。

この README は、コースの提出ガイドライン（目的、実行手順、サンプルクエリ）に従っています。