Israel Weather MCP

프로젝트 설명

이 프로젝트는 이스라엘 도시의 날씨 예보를 조회하기 위한 전용 MCP Server를 구현합니다.

외부 API 기반 구현과 달리, 이 프로젝트에서는 Playwright를 사용하여 브라우저에서 인간 사용자의 동작을 시뮬레이션합니다: 예보 사이트 열기, 도시 이름 입력, 드롭다운 목록에서 도시 선택, 결과 페이지에서 예보 데이터 추출.

이 프로젝트의 목적은 MCP와 브라우저 자동화 도구를 통해 LLM의 기능을 확장하는 방법을 보여주는 것입니다. 이를 통해 모델은 질문에 답할 수 있을 뿐만 아니라 정보 수집을 위해 실제 작업을 수행할 수도 있습니다.

Related MCP server: mcp-playwright-weather-israel

학습 목표

이 프로젝트에서는 다음과 같은 기능들이 구현되었습니다:

• 독립적인 MCP Server 구현

• LLM이 사용할 수 있는 Tools 노출

• Playwright를 사용한 브라우저 자동화

• 웹사이트에서 정보를 추출하고 깨끗한 텍스트 형식으로 반환

기술 스택

• Python

• MCP SDK

• Playwright

• 로컬 Google Chrome

프로젝트 구조

project-template/

├── client.py

├── host.py

├── weather_USA.py

├── weather_Israel.py

└── README.md

실행 방법

의존성 설치:

uv sync

프로젝트 실행:

uv run host.py

로컬 Chrome 설정

이 프로젝트는 로컬 Chrome 브라우저를 사용합니다.

weather_Israel.py 파일에서 실행 파일 경로를 설정해야 합니다:

LOCAL_CHROME = r"C:\Program Files\Google\Chrome\Application\chrome.exe"

Chrome이 다른 경로에 설치된 경우 그에 맞게 업데이트하세요.

구현된 Tools

open_weather_forecast_israel

예보 사이트를 엽니다.

enter_weather_forecast_city_israel

검색 필드에 도시 이름을 입력합니다.

select_weather_forecast_city_israel

자동 완성 목록에서 도시를 선택합니다.

get_weather_forecast_israel

전체 작업 시퀀스를 실행하고, 페이지에서 데이터를 추출하여 LLM이 사용할 수 있는 깨끗한 예보를 반환합니다.

쿼리 예시

예루살렘의 날씨는 어떤가요?

하이파의 예보는 무엇인가요?

텔아비브의 날씨는 어떤가요?

출력 예시

도시: 예루살렘

온도: 11.8°

마지막 업데이트: 19:10

습도: 71%

바람: 15.8 km/h

요약

이 프로젝트는 MCP와 Playwright를 사용하여 LLM이 실제 웹사이트와 상호작용하고, 실시간으로 정보를 수집하며, 사용자에게 집중되고 관련성 높은 답변을 반환할 수 있는 방법을 보여줍니다.