Israel Weather Forecast MCP Server

기존 API 호출이 아닌 실제 브라우저(Playwright)를 실행하여 이스라엘 날씨 예보를 가져오는 독립형 MCP 서버입니다. 아이디어: 모델(Host, 예: Claude Desktop / Claude Code)이 웹사이트를 탐색하는 인간 사용자처럼 tools를 하나씩 호출합니다. 페이지를 열고, 도시 이름을 입력하고, 자동 완성 목록에서 해당 도시를 선택한 다음, 마지막으로 페이지 콘텐츠를 추출하여 사용자의 질문에 답합니다.

프로젝트 구조

israel-weather-mcp/
├── server.py           # השרת עצמו - כל ה-tools מוגדרים כאן
├── requirements.txt
└── README.md

Related MCP server: Israel Weather MCP Agent

구현된 Tools

1단계 - 탐색 및 도시 검색

2단계 - 콘텐츠 추출 (RAG)

일반적인 흐름(LLM이 기대하는 호출 순서):

open_weather_forecast_israel
        ↓
enter_weather_forecast_city_israel("תל אביב")
        ↓
select_weather_forecast_city_israel("תל אביב")
        ↓
get_weather_forecast_content()   → הטקסט חוזר למודל, שמנסח תשובה למשתמש

설치

cd israel-weather-mcp
python -m venv .venv
source .venv/bin/activate        # ב-Windows: .venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium      # מוריד את הדפדפן שה-Playwright מפעיל

Host 연결 (예: Claude Desktop)

MCP 구성 파일(예: claude_desktop_config.json)에 다음을 추가해야 합니다:

{
  "mcpServers": {
    "israel-weather-forecast": {
      "command": "python",
      "args": ["/נתיב-מלא/israel-weather-mcp/server.py"]
    }
  }
}

저장한 후 Host를 다시 시작해야 합니다. tools는 사용 가능한 도구 목록에 표시되며, 예를 들어 *"오늘 하이파의 날씨 예보는 무엇인가요?"*라고 요청하면 Host는 답변하기 위해 tools를 하나씩 실행합니다.

셀렉터(Selectors)에 대한 중요 참고 사항

ims.gov.il 사이트의 정확한 HTML 구조(검색 상자, 자동 완성 항목, 예보 영역의 class/id 이름)는 사이트 업데이트에 따라 변경될 수 있습니다. 따라서 모든 셀렉터는 각 요소에 대한 몇 가지 대체(fallback) 옵션과 함께 server.py 상단의 SELECTORS 사전에 모아져 있습니다. 권장 사항:

1. 브라우저가 실제로 작동하는 모습을 보려면 server.py 파일에서 HEADLESS = False(일반 설정 근처 줄)로 실행하세요.

2. 일반 브라우저에서 예보 사이트를 열고, 검색 상자 / 자동 완성 목록 / 예보 영역에서 마우스 오른쪽 버튼을 클릭 → "검사"(Inspect)를 선택한 다음, 그에 따라 SELECTORS 사전의 목록을 업데이트하세요.

이렇게 하면 ims.gov.il 대신 다른 이스라엘 예보 사이트(예: 민간 기관의 사이트)로 서버를 전환하기로 결정한 경우에도 서버를 조정할 수 있습니다. IMS_FORECAST_URL과 SELECTORS만 업데이트하면 됩니다.

GitHub에 업로드

프로젝트는 이미 로컬 git 저장소로 준비되어 있습니다(초기 commit 포함). GitHub에 업로드하여 강사/선생님께 보낼 링크를 받으려면:

1. github.com에 접속하여 New repository를 클릭하세요("Add README" / ".gitignore" / "license"는 체크하지 마세요 - 이미 있으니까요).

2. 예를 들어 israel-weather-mcp와 같은 이름을 지정하고 Create repository를 클릭하세요.

3. 터미널에서 프로젝트 폴더(israel-weather-mcp/) 안에서 다음을 실행하세요:

   git remote add origin https://github.com/<שם-המשתמש-שלכם>/israel-weather-mcp.git
   git branch -M main
   git push -u origin main

4. push 후 강사에게 보낼 링크는 저장소 주소입니다: https://github.com/<שם-המשתמש-שלכם>/israel-weather-mcp

아직 컴퓨터에서 git을 처음 설정하지 않았다면 한 번 실행해야 할 수도 있습니다:

git config --global user.name "השם שלכם"
git config --global user.email "האימייל שלכם"

직접 실행 테스트 (Host 없이)

MCP CLI로 빠른 테스트를 실행할 수도 있습니다:

mcp dev server.py

이렇게 하면 Claude Desktop에 연결할 필요 없이 tools를 직접 호출하고 출력을 확인할 수 있는 로컬 테스트 인터페이스(MCP Inspector)가 열립니다.