한국 기상청 날씨 MCP 서버 설치·사용법 — 기상청 단기예보 API를 통해 한국 날씨 정보를 AI에 연결하기

Q: Smithery CLI가 없으면 어떻게 설치하나요?

npx는 Node.js에 포함된 실행기이므로 별도 설치 없이 npx -y @smithery/cli mcp add 명령을 바로 실행할 수 있습니다. Node.js 18 이상이 필요하며, nodejs.org에서 설치할 수 있습니다.

Q: Claude Code에서도 이 MCP 서버를 사용할 수 있나요?

네, Claude Code는 프로젝트 루트의 .mcp.json 파일에 서버 설정을 추가하면 됩니다. Claude Desktop과 동일한 서버를 사용하며, API 키도 동일하게 환경 변수로 전달합니다.

한국 기상청 단기예보 API를 AI 어시스턴트에 직접 연결하고 싶다면, Korea Weather MCP Server를 Claude 또는 Cursor에 설치하는 것이 가장 빠른 방법입니다. 공공데이터포털(data.go.kr)에서 API 키를 무료로 발급받고, Smithery CLI 한 줄 명령으로 서버를 추가하면 Claude 채팅창에서 “서울 내일 날씨 알려줘”처럼 자연어로 기상 예보를 조회할 수 있습니다. 이 가이드는 API 키 신청부터 설치, 실전 활용, 흔한 오류 해결까지 전 과정을 순서대로 안내합니다.

왜 기상청 MCP 서버가 필요한가

날씨 정보는 개발·운영 자동화, 여행 계획, 농업·물류 등 수많은 업무와 연결됩니다. 기존에는 기상청 홈페이지나 별도 앱을 열어 지역을 선택하고 예보를 읽어야 했습니다. 하지만 AI 워크플로우 안에서 날씨 판단이 필요할 때마다 수동으로 확인하는 것은 비효율적입니다.

MCP(Model Context Protocol)는 Claude 같은 AI 어시스턴트가 외부 API를 직접 호출할 수 있게 해주는 표준 인터페이스입니다. Korea Weather MCP Server를 연결하면 다음과 같은 데이터 흐름으로 날씨 정보가 실시간으로 전달됩니다.

사용자 자연어 질문
        │
        ▼
  Claude (AI 추론)
        │  MCP 도구 호출
        ▼
Korea Weather MCP Server
        │  REST API 요청 + API 키
        ▼
기상청 단기예보 조회서비스 (data.go.kr)
        │  JSON 예보 데이터 응답
        ▼
Claude → 한국어 요약·분석 답변
        │
        ▼
     사용자

Claude가 질문에서 지역·날짜를 파악해 자동으로 기상청 API를 호출하고, 응답 데이터를 사람이 읽기 쉬운 형태로 요약해 줍니다. 별도 앱 전환 없이 AI 대화 흐름 안에서 날씨를 확인할 수 있습니다.

Korea Weather MCP Server 개요

한국 기상청 날씨 MCP 서버는 GitHub 저장소(https://github.com/ohhan777/korea_weather)에서 관리되는 오픈소스 프로젝트입니다.

항목	내용
연동 API	기상청 단기예보 조회서비스 (data.go.kr)
설치 방식	Smithery CLI (npx)
API 키 필요	예 (공공데이터포털 무료 발급)
주요 제공 데이터	기온, 강수량, 강수 형태, 습도, 풍속, 풍향, 하늘 상태
예보 범위	단기예보 (약 3일 이내)
지원 클라이언트	Claude Desktop, Claude Code, Cursor 등 MCP 지원 환경

날씨 카테고리의 더 많은 서버는 날씨 카테고리에서 확인할 수 있습니다.

준비물

Node.js 18 이상 — 터미널에서 node -v로 버전 확인. 없으면 nodejs.org에서 설치
Claude Desktop 앱 — claude.ai에서 다운로드 (또는 Cursor)
공공데이터포털 계정 및 API 키 — data.go.kr 가입 후 기상청 단기예보 API 신청

단계별 설치 방법

1단계: 공공데이터포털 API 키 발급

기상청 단기예보 조회서비스 API 키는 공공데이터포털에서 무료로 발급받습니다.

공공데이터포털(https://www.data.go.kr)에 접속해 회원가입 또는 로그인합니다.
검색창에 **“기상청 단기예보 조회서비스”**를 입력해 해당 API 페이지로 이동합니다.
직접 URL로 접근하려면 https://www.data.go.kr/data/15084084/openapi.do 를 이용하세요.
활용 신청 버튼을 클릭하고 활용 목적을 간단히 입력한 뒤 신청합니다.
승인 완료(즉시 또는 최대 1~2 영업일) 후 마이페이지 > API 키 관리에서 인증키를 복사합니다.

발급된 인증키는 안전한 곳에 보관하세요. 이 키는 다음 단계에서 환경 변수로 사용합니다.

2단계: Smithery CLI로 서버 설치

터미널(macOS: Terminal, Windows: PowerShell)을 열고 아래 명령을 실행합니다. 이 명령 한 줄로 Korea Weather MCP Server가 Claude Desktop에 자동 등록됩니다.

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

Smithery CLI는 npx가 있으면 별도 설치 없이 바로 실행됩니다. 명령 실행 후 API 키 입력을 요청하는 프롬프트가 나타날 수 있습니다.

3단계: API 키 환경 변수 설정

Smithery CLI가 자동으로 설정 파일을 수정하지만, API 키가 올바르게 전달됐는지 수동으로 확인하는 것이 좋습니다. Claude Desktop의 MCP 설정 파일 위치는 운영체제별로 다릅니다.

운영체제	설정 파일 경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

텍스트 편집기로 해당 파일을 열면 아래와 유사한 구조가 이미 추가돼 있어야 합니다. API 키 값이 실제 발급받은 인증키로 채워져 있는지 확인하세요.

{
  "mcpServers": {
    "korea_weather": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "ohhan777/korea_weather"],
      "env": {
        "API_KEY": "여기에_공공데이터포털_인증키_입력"
      }
    }
  }
}

API 키 값을 1단계에서 발급받은 실제 인증키로 교체합니다. JSON 파일에서 쉼표 위치나 따옴표 누락이 발생하면 Claude가 서버를 인식하지 못하므로 주의하세요.

4단계: Claude 재시작 및 연결 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 시작합니다. 채팅창 하단 도구 목록에 날씨 관련 MCP 도구가 표시되면 정상 연결된 것입니다.

간단한 테스트 질문으로 연결을 확인해 보세요.

서울 내일 날씨 알려줘

Claude가 기상청 API를 호출해 기온, 강수 확률, 하늘 상태 등을 포함한 예보를 답변해 준다면 설치가 완료된 것입니다.

5단계: 기상청 단기예보 실전 활용

연결이 확인되면 다양한 날씨 관련 질문을 시도할 수 있습니다.

활용 예시

부산 이번 주말 날씨 예보를 알려줘
내일 오후에 제주도에서 우산이 필요할까?
오늘 인천 최고·최저 기온이 얼마야?
이번 주 서울 날씨를 표로 정리해 줘

기상청 단기예보 API는 격자 좌표 기반으로 동작하므로, 서버가 지역명을 격자 좌표로 자동 변환해 API를 호출합니다. 큰 도시명이나 시·군·구 단위 지명을 자연어로 입력해도 됩니다.

흔한 오류와 해결 방법

오류 상황	원인	해결 방법
Claude가 날씨 도구를 표시하지 않음	설정 파일 JSON 문법 오류	온라인 JSON 검증 도구로 문법 확인 후 재시작
”API 인증 실패” 또는 응답 없음	API 키 오타 또는 미승인 상태	data.go.kr 마이페이지에서 키 승인 여부 확인
npx 명령을 찾을 수 없음	Node.js 미설치	nodejs.org에서 Node.js 18 이상 설치 후 재시도
지역명 인식 오류	지원하지 않는 지역명 형식	시·도, 시·군·구 단위 지명으로 바꿔 질문
응답이 느리거나 타임아웃	공공데이터포털 호출 한도 초과	data.go.kr 마이페이지에서 일별 사용량 확인
Windows에서 경로 오류	환경 변수 인식 문제	관리자 권한으로 PowerShell 실행 후 재시도

API 키가 방금 발급됐다면 승인 처리에 시간이 걸릴 수 있습니다. 신청 직후 바로 사용하려 하면 인증 오류가 발생할 수 있으니, 승인 이메일을 확인한 뒤 시도하는 것이 좋습니다.

Cursor에서 사용하는 방법

Cursor도 MCP를 지원합니다. Cursor 설정(Settings) 메뉴에서 MCP 서버 항목을 찾아 아래 설정을 추가하면 됩니다.

{
  "mcpServers": {
    "korea_weather": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "ohhan777/korea_weather"],
      "env": {
        "API_KEY": "여기에_공공데이터포털_인증키_입력"
      }
    }
  }
}

Cursor를 재시작하면 AI 채팅에서 동일하게 기상청 날씨 데이터를 조회할 수 있습니다.

날씨 데이터 활용 아이디어

기상청 MCP 서버를 Claude에 연결하면 단순한 날씨 조회를 넘어 다양한 자동화로 확장할 수 있습니다.

여행 계획 자동화: 목적지 날씨를 확인하면서 일정표 초안을 작성
코드 실행 조건 분기: 날씨 데이터를 기반으로 스크립트 동작 방식 변경
리포트 자동 생성: 특정 기간의 날씨 데이터를 표 형식으로 정리해 문서화
알림 자동화: Claude Code 에이전트가 날씨 조건을 확인해 후속 작업 결정

전체 MCP 서버 목록에서 날씨 외에도 다양한 한국 공공 API MCP 서버를 찾아볼 수 있습니다.

자주 묻는 질문

기상청 단기예보 API 키는 무료로 발급받을 수 있나요?

네, 공공데이터포털(data.go.kr)의 기상청 단기예보 조회서비스 API는 회원가입 후 무료로 신청할 수 있습니다. 승인까지 최대 1~2 영업일이 소요될 수 있으며, 일별 호출 한도가 정해져 있습니다.

Korea Weather MCP Server는 어떤 날씨 정보를 제공하나요?

기상청 단기예보 API를 기반으로 기온, 강수량, 강수 형태, 습도, 풍속, 풍향, 하늘 상태 등 단기(3일 이내) 예보 데이터를 제공합니다. 장기 예보나 기상 특보는 별도 API가 필요합니다.

Smithery CLI가 없으면 어떻게 설치하나요?

npx는 Node.js에 포함된 실행기이므로 별도 설치 없이 npx -y @smithery/cli mcp add 명령을 바로 실행할 수 있습니다. Node.js 18 이상이 필요하며, nodejs.org에서 설치할 수 있습니다.

Claude Code에서도 이 MCP 서버를 사용할 수 있나요?

네, Claude Code는 프로젝트 루트의 .mcp.json 파일에 서버 설정을 추가하면 됩니다. Claude Desktop과 동일한 서버를 사용하며, API 키도 동일하게 환경 변수로 전달합니다.

MCP 서버를 추가했는데 Claude가 날씨 도구를 인식하지 못하면 어떻게 하나요?

Claude Desktop을 완전히 종료 후 재시작하고, 설정 파일의 JSON 문법(쉼표 위치, 따옴표 쌍)을 확인하세요. API 키에 공백이나 오타가 없는지도 점검해야 합니다.

Cursor에서도 기상청 날씨 MCP를 사용할 수 있나요?

Cursor는 MCP 프로토콜을 지원합니다. Cursor 설정의 MCP 서버 항목에 동일한 서버 명령과 API 키 환경 변수를 추가하면 Cursor 채팅에서도 기상청 예보 데이터를 조회할 수 있습니다.

다음 단계

Korea Weather MCP Server가 정상적으로 동작한다면, 다음 단계로 활용 범위를 넓혀 보세요.

한국 기상청 날씨 MCP 서버 상세 정보: GitHub 저장소 및 최신 업데이트 확인
날씨 카테고리 전체 보기: 기상 관련 다른 MCP 서버 탐색
전체 서버 목록: 한국 공공 API를 활용한 다양한 MCP 서버 확인

직접 개발한 날씨·기상 관련 MCP 서버가 있다면 MCP모아에 등록해 더 많은 사람들과 공유해 보세요.