🌤️ Israel Weather MCP Server

Un servidor personalizado del Model Context Protocol (MCP) que permite a los LLM obtener pronósticos meteorológicos localizados en tiempo real y de alta precisión para ciudades israelíes.

En lugar de depender de APIs globales genéricas, este agente utiliza Playwright para navegar de forma autónoma hasta el portal meteorológico israelí local (weather2day.co.il), interactuar con el DOM y extraer datos en vivo (RAG) directamente en el contexto del chat.

🎯 Propósito del Proyecto

Este proyecto explora la integración del control autónomo del navegador dentro de una arquitectura de Agente de IA. Los principales objetivos de aprendizaje alcanzados son:

1. Desarrollo de un Servidor MCP Personalizado: Crear un servidor dedicado para exponer herramientas específicas a un LLM.

2. Automatización del Navegador mediante IA: Usar Playwright de Microsoft para darle al LLM "manos" y "ojos" en la web, permitiéndole navegar, buscar, seleccionar opciones de listas desplegables de autocompletado y extraer datos de forma dinámica.

3. Superando Barreras de Idioma y Estado: Gestionar interacciones web con estado (esperar animaciones, escribir secuencialmente) y garantizar que el LLM traduzca correctamente las consultas al hebreo antes de interactuar con los elementos de la interfaz local.

🛠️ Stack Tecnológico

• MCP SDK: La biblioteca oficial de Anthropic para definir el protocolo y exponer herramientas.

• Playwright: Herramienta moderna de automatización de navegador utilizada para controlar Chromium de forma programática.

• uv: Gestor de paquetes y entornos de Python ultrarrápido.

🚀 Cómo Ejecutarlo

1. Requisitos Previos

Asegúrate de tener uv instalado en tu sistema.

• 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. Configurar el Entorno

Clona el repositorio, navega a la carpeta project-template y sincroniza las dependencias:

uv sync

3. Instalar el Motor del Navegador

Instala el navegador Chromium requerido por Playwright:

uv run playwright install chromium

4. Iniciar el Host

Ejecuta el chat interactivo de terminal para comenzar a comunicarte con el Agente:

uv run host.py

💬 Ejemplos de Consultas

Una vez que el Host esté en ejecución, puedes hacerle preguntas al Agente como:

• "¿Cuál es el pronóstico en Jerusalén?"

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

• "¿Va a llover en Haifa mañana?"

Observa la magia en acción: El Agente abrirá automáticamente Chromium, traducirá el nombre de la ciudad al hebreo, la buscará, seleccionará la opción correcta de autocompletado, extraerá el pronóstico más reciente y te proporcionará una respuesta limpia y localizada directamente en la terminal.

Desarrollado por SARA DEI