Skip to main content
Glama
Weather MCP Server

Weather MCP Server

날씨 MCP 서버

National Weather Service (NWS) API를 사용하여 미국 날씨 정보를 제공하는 Model Context Protocol (MCP) 서버입니다. FastMCP로 구축되었습니다.

기능

이 서버는 AI 어시스턴트가 실시간 날씨 데이터를 가져올 수 있도록 다음과 같은 도구를 제공합니다:

  • get_alerts(state: str): 특정 미국 주(CA, NY, TX와 같은 2글자 주 코드 사용)에 대한 활성 날씨 경보를 가져옵니다. 이벤트, 심각도, 설명 및 안전 지침에 대한 세부 정보를 반환합니다.

  • get_forecast(latitude: float, longitude: float): 특정 위치(위도 및 경도 사용)에 대한 상세 날씨 예보를 가져옵니다. 향후 5개 기간(예: 오늘 오후, 오늘 밤, 내일 등)에 대한 예보를 반환합니다.

Related MCP server: weather-mcp

사전 요구 사항

  • Python 3.10 이상

  • uv 패키지 관리자

설치 및 설정

이 프로젝트는 의존성 관리를 위해 uv를 사용합니다. 설정 방법은 다음과 같습니다:

  1. 저장소 복제

  2. 의존성 설치 (uv를 사용하여 실행하면 가상 환경이 생성됩니다):

    uv sync

사용법

MCP 클라이언트가 상호 작용하는 방식인 표준 입출력을 통해 MCP 서버를 수동으로 실행할 수 있습니다:

uv run weather.py

Claude Desktop과 통합

이 서버를 Claude Desktop과 함께 사용하려면 claude_desktop_config.json에 추가해야 합니다:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/your/mcp-server",
        "run",
        "weather.py"
      ]
    }
  }
}

사용자 지정 MCP 클라이언트와 통합

사용자 지정 Python MCP 클라이언트가 있는 경우 다음과 같이 연결할 수 있습니다:

from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="uv",
    args=["--directory", "path/to/mcp-server", "run", "weather.py"],
    env=None
)
# Pass server_params to your MCP client

사용된 API

Available Tools

2 tools
get_alertsA

Get weather alerts for a US state.

Args: state: Two-letter US state code (e.g. CA, NY)

Inputs: state (required). Returns: result

get_forecastC

Get weather forecast for a location.

Args: latitude: Latitude of the location longitude: Longitude of the location

Inputs: latitude (required), longitude (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    get_alerts and get_forecast have clearly distinct purposes: one for weather alerts by state, the other for forecast by coordinates. No overlap exists.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (get_alerts, get_forecast), making them predictable.

    Tool Count3/5

    With only 2 tools, the server feels thin for a weather domain, bordering on insufficient scope.

    Completeness2/5

    Common weather operations like current conditions, hourly forecast, or radar are missing, leaving significant gaps for typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers