Weather MCP

Open-Meteo에서 날씨 데이터를 제공하고 MCP Apps를 통해 대화형 날씨 대시보드를 렌더링하는 FastMCP 서버입니다.

기능

• 도시 또는 장소 이름으로 위치 검색

• 현재 기상 상태 및 최대 16일 예보 확인

• 섭씨와 화씨 간 전환

• 날씨 설명 및 상태 기호 표시

• 위치 및 예보 응답을 5분간 캐시

• 호환되는 MCP 호스트 내에서 대시보드를 직접 렌더링

Related MCP server: bridgemcp-server-weather

요구 사항

• Python 3.14+

• uv

• 대화형 대시보드를 위한 MCP Apps 지원 MCP 호스트

설정

프로젝트 종속성을 설치합니다:

uv sync

일반적인 비상업적 Open-Meteo 사용에는 날씨 API 키가 필요하지 않습니다.

서버 실행

기본 stdio 전송으로 서버를 실행합니다:

uv run python main.py

등록된 도구를 확인합니다:

uv run fastmcp list main.py

대시보드 미리보기

FastMCP에는 앱 도구용 로컬 브라우저 미리보기가 포함되어 있습니다:

uv run fastmcp dev apps main.py

표시된 로컬 URL을 열고 weather_dashboard를 선택합니다. 대시보드는 다른 위치 검색 및 온도 단위 전환을 지원합니다.

MCP 도구

search_locations

일치하는 위치를 찾아 좌표, 국가, 지역 및 시간대를 반환합니다.

get_weather

위치의 현재 날씨와 일일 예보를 가져옵니다.

인수:

• location: 도시 또는 장소 이름

• forecast_days: 1~16일의 예보 일수

• temperature_unit: celsius 또는 fahrenheit

weather_dashboard

동일한 날씨 인수로 대화형 날씨 대시보드를 엽니다.

프로젝트 구조

main.py                         MCP server entry point
src/tools.py                    MCP tool registration and response shaping
src/services/weather_service.py Open-Meteo client and response cache
src/formatting.py               UI-friendly forecast formatting
src/dashboard.py                Prefab MCP App UI

데이터 소스

날씨 데이터는 여러 국가 기상 서비스의 예보를 결합하는 Open-Meteo에서 제공됩니다. 상업적 배포 전에 Open-Meteo 이용 약관 및 라이선스를 검토하세요.