WeatherAI MCP 서버

AI 어시스턴트를 위한 11가지 실시간 날씨 도구 — 하나의 URL, 별도 설정 불필요.

WeatherAI MCP 서버는 Claude Desktop, Cursor, Windsurf 및 모든 MCP 호환 AI 어시스턴트에게 실시간 날씨, 예보, 과거 데이터, 대기질, 천문 정보, 태양 복사량 및 평이한 영어로 된 AI 날씨 인터페이스에 대한 즉각적인 액세스를 제공합니다.

호스팅 엔드포인트: https://api.weatherai.io/mcp
전송 방식: Streamable HTTP (상태 비저장, MCP 사양 2025-03-26)
인증: 쿼리 매개변수, 헤더 또는 Bearer 토큰을 통한 API 키
무료 티어: 일일 1,000회 표준 호출 · 일일 50회 프리미엄 호출

빠른 시작

1. 무료 API 키 받기

weatherai.io에서 가입하세요 — 신용카드가 필요하지 않습니다.

2. AI 클라이언트에 추가하기

YOUR_API_KEY를 대시보드에서 받은 키로 교체하세요.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)을 편집하세요:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

저장 후 Claude Desktop을 다시 시작하세요.

Cursor

Cursor → Settings → MCP로 이동하거나 ~/.cursor/mcp.json을 편집하세요:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json을 편집하세요:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http"
    }
  }
}

기타 MCP 클라이언트 (일반 mcp.json)

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http",
      "transport": "streamable-http"
    }
  }
}

3. 날씨 질문 시작하기

"What's the weather like in Tokyo right now?"
"Will it rain in London this weekend?"
"What were temperatures in Paris on 14 July 2023?"
"What's the air quality like in Beijing?"
"When does the sun set in Dubai today?"

Related MCP server: ambient-mcp

사용 가능한 도구

11가지 도구 모두 자동으로 등록되므로 별도의 설정이 필요 없습니다.

도구 세부 정보

get_current_weather

기온, 체감 온도, 습도, 풍속/풍향, 자외선 지수, 가시거리, 기압 및 구름 덮임을 반환합니다.

location  (required) City name, US zip, UK postcode, lat/lon, or IP address
units     (optional) "metric" | "imperial" — default: metric

get_weather_forecast

강수 확률과 자외선 지수를 포함하여 최대 14일간의 일일 최고/최저 기온 및 시간별 분석을 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address
days      (optional) 1–14 — default: 3
units     (optional) "metric" | "imperial" — default: metric

get_historical_weather

과거 특정 날짜에 대한 시간별 실제 기록된 날씨를 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (required) YYYY-MM-DD format — must be a past date
units     (optional) "metric" | "imperial" — default: metric

get_future_weather

14일에서 300일 후까지의 AI 강화 장기 예보입니다. 요청당 2 프리미엄 크레딧이 차감됩니다.

location    (required) City name, zip/postcode, coordinates, or IP address
start_date  (required) YYYY-MM-DD — 14–300 days from today
end_date    (optional) YYYY-MM-DD — max 30 days per request
units       (optional) "metric" | "imperial" — default: metric

get_air_quality

실시간 AQI 지수와 개별 오염 물질 측정값(PM2.5, PM10, CO, NO2, SO2, O3)을 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address

get_weather_alerts

정부에서 발행한 활성 폭풍, 홍수, 폭염 및 기타 날씨 경보를 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address

get_astronomy

일출, 일몰, 월출, 월몰, 달의 위상 이름 및 조명 비율을 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today

get_solar_data

태양 복사량(W/m²) 및 추정 일일 에너지 생산량(kWh/m²)을 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today
units     (optional) "metric" | "imperial" — default: metric

get_timezone

IANA 시간대 이름, UTC 오프셋(시간), 현재 현지 시간 및 일광 절약 시간제 활성 여부를 제공합니다.

location  (required) City name, zip/postcode, coordinates, or IP address

search_locations

이름, 지역, 국가 및 좌표가 포함된 최대 10개의 일치하는 장소를 반환합니다.

query  (required) Partial or full city/location name

ask_ai_weather ⭐

평이한 영어로 날씨 관련 질문을 하세요. AI가 의도를 해석하고 관련 도구를 호출하여 자연어 답변과 기본 JSON 데이터를 반환합니다. 요청당 2 프리미엄 크레딧이 차감됩니다.

question  (required) e.g. "Will it be good weather for hiking in the Lake District next weekend?"

인증

세 가지 방법이 지원되며 모두 동일하게 작동합니다:

클라이언트 구성 파일에는 쿼리 매개변수를 권장합니다. 프로그래밍 방식의 액세스에는 헤더를 사용하세요.

요금

크레딧은 선불 방식입니다 — 대시보드에서 충전하세요. 구독이 필요하지 않습니다.

표준 도구: get_current_weather, get_weather_forecast, get_air_quality, get_weather_alerts, get_astronomy, get_timezone, search_locations

프리미엄 도구: get_historical_weather, get_future_weather, get_solar_data, ask_ai_weather

기계 판독 가능한 검색

소스 코드

이 저장소에는 MCP 서버 구현이 포함되어 있습니다. 서버는 https://api.weatherai.io/mcp에서 WeatherAI.io 플랫폼의 일부로 실행됩니다.

src/index.ts는 독립적으로 실행할 수 있는 자체 포함 어댑테이션입니다:

npm install
WEATHERAI_API_KEY=your_key npm start

독립형 서버는 PORT(기본값 3000)에서 수신 대기하며 동일한 /mcp 엔드포인트를 노출합니다.

링크

• 웹사이트: weatherai.io

• MCP 문서: weatherai.io/mcp

• API 문서: weatherai.io/docs

• 요금: weatherai.io/pricing

• 가입: weatherai.io/register

라이선스

MIT — LICENSE를 참조하세요.

영국 Zoomash Ltd에서 제작 (회사 번호 7838145).