🌤️ イスラエル天気 MCP サーバー

LLM がイスラエルの都市向けのリアルタイムで高精度なローカライズされた天気予報を取得できるようにするカスタム Model Context Protocol (MCP) サーバーです。

このエージェントは、汎用のグローバル API に頼るのではなく、Playwright を利用して、イスラエルのローカル天気ポータル (weather2day.co.il) を自律的に操作し、DOM と対話して、ライブデータ (RAG) をチャットコンテキストに直接抽出します。

🎯 プロジェクトの目的

このプロジェクトは、AI エージェントアーキテクチャ内での自律的なブラウザ制御の統合を探求します。

達成された主な学習目標は次のとおりです。

1. カスタム MCP サーバーの開発: LLM に特定のツールを公開する専用サーバーを構築します。

2. AI によるブラウザ自動化: Microsoft の Playwright を使用して、LLM に Web 上の「手」と「目」を与え、ナビゲーション、検索、オートコンプリートのドロップダウンからの選択、データの動的なスクレイピングを可能にします。

3. 言語と状態の壁の克服: ステートフルな Web インタラクション（アニメーションの待機、順次入力）を処理し、LLM がローカル UI 要素と対話する前にクエリをヘブライ語に正確に翻訳できるようにします。

🛠️ 技術スタック

• MCP SDK: プロトコルを定義しツールを公開するための公式 Anthropic ライブラリ。

• Playwright: Chromium をプログラムで制御するための最新のブラウザ自動化ツール。

• uv: 超高速の Python パッケージおよび環境マネージャー。

🚀 実行方法

1. 前提条件

システムに uv がインストールされていることを確認してください。

• Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Mac/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

2. 環境のセットアップ

リポジトリをクローンし、project-template フォルダーに移動して、依存関係を同期します:

uv sync

3. ブラウザエンジンのインストール

Playwright に必要な Chromium ブラウザをインストールします:

uv run playwright install chromium

4. ホストを起動

エージェントとの通信を開始するには、インタラクティブなターミナルチャットを実行します:

uv run host.py

💬 クエリの例

ホストが起動したら、エージェントに次のような質問をできます:

• エルサレムの天気予報は？

• מה מזג האוויר בתל אביב היום?

• 明日ハイファで雨は降りますか？

魔法が起こるのを見てください: エージェントが自動的に Chromium を開き、都市名をヘブライ語に翻訳して検索し、正しいオートコンプリートオプションを選択し、最新の予報をスクレイピングして、ターミナル内でクリーンでローカライズされた回答を提供します。

SARA DEI によって開発されました