날씨 MCP 서버 총정리 — 기상청·OpenWeather 한국어 비교 가이드

Q: Claude Desktop과 Claude Code 모두에서 사용할 수 있나요?

네, 두 환경 모두 지원합니다. Claude Desktop은 claude_desktop_config.json 파일에, Claude Code는 프로젝트 내 .mcp.json 또는 사용자 설정에 MCP 서버를 등록해 사용합니다. 본문의 설정 예시를 참고하세요.

Q: API 키를 설정 파일에 직접 적어도 안전한가요?

설정 파일을 버전 관리(git)에 올릴 경우 API 키가 노출될 수 있습니다. .gitignore에 설정 파일을 추가하거나, 환경변수로 관리하는 방법이 더 안전합니다. 개인 로컬 환경에서만 사용한다면 설정 파일에 직접 입력해도 무방합니다.

Claude 같은 AI 에이전트에서 실시간 날씨 정보가 필요하다면, MCP(Model Context Protocol) 서버를 통해 기상청 API를 직접 연결하는 것이 가장 확실한 방법입니다. Korea Weather MCP Server 하나를 설치하면 “서울 내일 날씨 알려줘”부터 특정 지점의 단기예보 조회까지 Claude 대화창에서 바로 실행할 수 있습니다. 이 가이드는 기상청 API 키 발급부터 Claude 연동, 흔한 오류 해결까지 한국어로 완전하게 안내합니다.

왜 AI 에이전트에 날씨 MCP가 필요한가

Claude는 학습 데이터 기준 날짜 이후의 정보를 알지 못합니다. 오늘 날씨, 내일 오전 기온, 주말 강수 확률 같은 실시간 기상 데이터는 Claude가 자체적으로 답할 수 없습니다. 사용자가 날씨를 물으면 “저는 실시간 날씨 정보에 접근할 수 없습니다”라는 답변만 돌아옵니다.

MCP 서버는 이 문제를 구조적으로 해결합니다. Claude가 대화 중에 날씨 도구(tool)를 직접 호출해 기상청 API에서 최신 데이터를 가져오고, 그 결과를 바탕으로 답변을 생성합니다. 일정 자동화, 여행 계획 에이전트, 농업·물류 자동화 등 날씨 정보가 필요한 다양한 AI 워크플로에 핵심 역할을 합니다.

사용자 ("서울 내일 날씨 알려줘")
    │
    ▼
Claude (AI 클라이언트)
    │  날씨 도구 호출
    ▼
Korea Weather MCP Server
    │  기상청 단기예보 조회서비스 요청
    ▼
data.go.kr (공공데이터포털)
    │  격자 좌표 기반 예보 데이터 반환
    ▼
Claude — 자연어로 날씨 요약 제공

날씨 MCP 서버 비교: 무엇이 있나

현재 한국어 환경에서 주목할 만한 날씨 MCP 서버는 다음과 같습니다.

서버 이름	데이터 소스	한국 날씨	API 키 필요	설치 방식
Korea Weather MCP Server	기상청 단기예보	전용 지원	필요 (data.go.kr)	npx (Smithery)
기타 OpenWeather 기반	OpenWeatherMap	글로벌	필요 (openweathermap.org)	서버마다 상이

Korea Weather MCP Server(GitHub)는 기상청 공식 단기예보 API를 사용하므로 한국 지역 날씨 정확도가 높습니다. 격자 좌표(nx, ny) 기반으로 동·읍·면 수준까지 세밀하게 조회할 수 있다는 것이 가장 큰 장점입니다.

날씨 카테고리의 전체 MCP 서버 목록에서 추가 옵션을 확인할 수 있습니다.

준비물

기상청 날씨 MCP를 사용하려면 다음을 미리 준비해야 합니다.

기상청 단기예보 API 키: 공공데이터포털(data.go.kr)에서 무료 발급
Node.js 18 이상: npx 실행에 필요
Claude Desktop 또는 Claude Code: MCP 클라이언트 역할

단계 1 — 기상청 API 키 발급

공공데이터포털에 접속해 회원가입 또는 로그인합니다.
‘기상청_단기예보 조회서비스’ 페이지에서 활용 신청 버튼을 클릭합니다.
활용 목적 등을 간단히 입력하고 신청을 완료합니다. 승인은 즉시 또는 1~2 영업일 내에 처리됩니다.
마이페이지 → 오픈API → 내 오픈 API 에서 발급된 일반 인증키(Encoding) 를 복사합니다.

이 키는 이후 MCP 서버 설정에 환경변수로 사용합니다.

단계 2 — Korea Weather MCP Server 설치

Smithery CLI를 통해 Claude에 자동으로 등록하는 방법이 가장 간편합니다.

npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude

명령 실행 후 Smithery가 API 키를 물어보면 앞서 발급받은 기상청 인증키를 입력합니다. 설치가 완료되면 Claude Desktop 설정 파일이 자동으로 갱신됩니다.

수동 설정 방법 (Claude Desktop)

Smithery를 사용하지 않고 직접 설정하려면 Claude Desktop의 설정 파일을 엽니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

아래 내용을 mcpServers 항목에 추가합니다.

{
  "mcpServers": {
    "korea-weather": {
      "command": "npx",
      "args": ["-y", "ohhan777/korea_weather"],
      "env": {
        "WEATHER_API_KEY": "여기에_기상청_인증키_입력"
      }
    }
  }
}

설정 파일 저장 후 Claude Desktop을 완전히 종료했다가 다시 실행해야 MCP 서버가 활성화됩니다.

단계 3 — 설치 확인 및 테스트

Claude Desktop을 재시작한 뒤, 채팅창에서 MCP 도구가 연결됐는지 확인합니다. 연결이 정상이라면 Claude에 아래와 같이 물어봤을 때 실시간 예보 데이터를 포함한 답변이 돌아옵니다.

예시 프롬프트:

서울 강남구 내일 날씨 예보를 알려줘.

부산의 이번 주말 강수 확률과 최저 기온을 알려줘.

Claude가 “날씨 정보를 조회하겠습니다”라고 도구 호출을 표시하며 응답을 생성하면 정상적으로 작동하는 것입니다.

격자 좌표 이해하기

기상청 단기예보 API는 경위도가 아닌 격자 좌표(nx, ny) 로 지점을 지정합니다. 주요 도시별 격자 좌표는 다음과 같습니다.

지역	nx	ny
서울 (중구)	60	127
부산 (중구)	98	76
대구 (중구)	89	90
인천 (중구)	55	124
광주 (동구)	58	74
대전 (유성구)	67	100
제주 (제주시)	52	38

기상청 홈페이지에서 제공하는 격자-위경도 변환 엑셀 파일을 활용하면 원하는 읍·면·동의 격자 좌표를 조회할 수 있습니다.

MCP 서버 자체가 자연어로 입력한 지역명을 격자 좌표로 변환해 주는 경우에는 위 표 없이 “강남구”, “해운대구” 등으로 직접 질의할 수도 있습니다. 서버의 지원 범위는 Korea Weather MCP 저장소의 README를 참고하세요.

흔한 오류와 해결 방법

설치 후 문제가 생길 경우 아래 체크리스트를 순서대로 확인하세요.

오류: 도구가 Claude에 나타나지 않음

Claude Desktop을 완전히 종료 후 재시작했는지 확인합니다.
설정 파일의 JSON 문법(쉼표, 중괄호)이 올바른지 검토합니다. JSON 유효성 검사기를 활용하면 편리합니다.

오류: API 인증 실패 (401, 인증 오류)

WEATHER_API_KEY 값이 정확히 입력됐는지 확인합니다.
공공데이터포털에서 활용 신청 상태가 ‘승인’인지 확인합니다. ‘신청’ 상태에서는 키가 동작하지 않습니다.
일반 인증키(Encoding)와 일반 인증키(Decoding) 중 Encoding 키를 사용해야 합니다.

오류: 날씨 데이터 없음 또는 빈 응답

격자 좌표가 유효한 범위인지 확인합니다. 잘못된 nx, ny 값을 입력하면 빈 결과가 반환됩니다.
기상청 API는 특정 시간대(정시 전후)에 일시적으로 응답이 지연될 수 있습니다. 잠시 후 재시도해 보세요.

오류: npx 명령어를 찾을 수 없음

Node.js가 설치되어 있는지 확인합니다. node -v 명령으로 버전을 확인하고, 없다면 nodejs.org에서 설치합니다.

날씨 MCP 활용 아이디어

날씨 데이터를 AI 에이전트에 연결하면 단순 날씨 조회를 넘어 다양한 자동화가 가능합니다.

일정 최적화: 캘린더 MCP와 결합해 비 오는 날 야외 일정을 자동으로 재배치
농업·시설 관리: 기온·강수 예보를 바탕으로 관개 일정 자동 생성
배달·물류: 날씨 악화 지역의 배달 예상 지연 시간을 에이전트가 안내
여행 계획: 목적지 날씨 예보를 포함한 여행 일정 초안 자동 작성
농작물 병해 예측: 온도·습도 데이터를 활용한 작황 관리 자동화

전체 MCP 서버 디렉토리에서 날씨 외에도 지도, 교통, 공공 데이터 등 다양한 서버를 함께 활용할 수 있습니다.

자주 묻는 질문

기상청 API 키는 어디서 발급받나요?

공공데이터포털(data.go.kr)에 회원가입 후 ‘기상청_단기예보 조회서비스’를 검색해 활용 신청을 하면 됩니다. 승인은 보통 즉시 또는 1~2 영업일 내에 완료되며, 발급된 일반 인증키(Encoding)를 복사해 사용합니다.

기상청 날씨 MCP 서버는 실시간 날씨를 제공하나요?

기상청 단기예보 API는 약 1시간 단위로 갱신되는 단기예보 데이터를 제공합니다. 완전한 실시간 관측 데이터가 아니라 예보값이지만, 현재 날씨 파악과 단기 계획 수립에는 충분한 정밀도입니다.

Claude Desktop과 Claude Code 모두에서 사용할 수 있나요?

네, 두 환경 모두 지원합니다. Claude Desktop은 claude_desktop_config.json 파일에, Claude Code는 프로젝트 내 .mcp.json 또는 사용자 설정에 MCP 서버를 등록해 사용합니다. 본문의 설정 예시를 참고하세요.

한국 이외 해외 도시 날씨도 조회할 수 있나요?

Korea Weather MCP Server는 기상청 API를 사용하므로 기본적으로 한국 내 지점(격자 좌표 기반)의 날씨 정보를 제공합니다. 해외 날씨가 필요하다면 OpenWeatherMap 등 글로벌 API를 사용하는 별도 MCP 서버를 함께 구성하는 것을 권장합니다.

API 키를 설정 파일에 직접 적어도 안전한가요?

설정 파일을 버전 관리(git)에 올릴 경우 API 키가 노출될 수 있습니다. .gitignore에 설정 파일을 추가하거나, 환경변수로 관리하는 방법이 더 안전합니다. 개인 로컬 환경에서만 사용한다면 설정 파일에 직접 입력해도 무방합니다.

날씨 도구가 응답이 없거나 오류를 반환하면 어떻게 해야 하나요?

API 키가 올바른지, 기상청 API 서비스 가동 상태를 먼저 확인하세요. 격자 좌표(nx, ny) 값이 잘못된 경우에도 오류가 발생합니다. 공공데이터포털 마이페이지에서 호출 현황을 확인하면 키 유효 여부를 파악할 수 있습니다.

다음 단계

날씨 MCP 서버를 Claude에 성공적으로 연결했다면, 이제 다양한 API와 조합해 더 강력한 AI 에이전트를 구축할 수 있습니다.

한국 기상청 날씨 MCP 서버 상세 정보에서 사용 가능한 도구 목록과 예시 쿼리를 확인해 보세요.
날씨 카테고리 전체 서버에서 다른 기상 관련 MCP 서버를 탐색해 보세요.
새로운 MCP 서버를 발견했다면 MCP모아 서버 디렉토리에서 더 많은 서버를 찾아보거나, 직접 서버를 등록해 한국 MCP 생태계 성장에 기여할 수도 있습니다.
가이드 전체 목록에서 다른 MCP 서버 연동 튜토리얼도 확인해 보세요.