🌤️ 이스라엘 날씨 MCP 서버

LLM이 이스라엘 도시들의 실시간, 고도로 정확한 지역 날씨 예보를 가져올 수 있게 해주는 맞춤형 Model Context Protocol(MCP) 서버입니다.

일반적인 글로벌 API에 의존하는 대신, 이 에이전트는 Playwright를 사용하여 이스라엘 현지 날씨 포털(weather2day.co.il)을 자율적으로 탐색하고, DOM과 상호작용하며, 실시간 데이터(RAG)를 채팅 컨텍스트로 직접 추출합니다.

🎯 프로젝트 목적

이 프로젝트는 AI 에이전트 아키텍처 내에서 자율 브라우저 제어의 통합을 탐구합니다. 달성한 주요 학습 목표는 다음과 같습니다.

1. 맞춤형 MCP 서버 개발: LLM에 특정 도구를 노출하기 위한 전용 서버 구축.

2. AI를 통한 브라우저 자동화: Microsoft의 Playwright를 사용하여 LLM에게 웹상의 "손"과 "눈"을 제공—탐색, 검색, 자동 완성 드롭다운에서 선택, 데이터 동적 스크래핑을 가능하게 함.

3. 언어 및 상태 장벽 극복: 상태 저장 웹 상호작용(애니메이션 대기, 순차적 타이핑) 처리 및 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 개발