M MCP모아
튜토리얼

기상청 MCP 서버 만들기 — Claude로 한국 실시간 날씨 조회하는 방법

기상청 단기예보 API를 MCP 서버로 연결해 Claude에서 한국 실시간 날씨를 조회하는 방법을 단계별로 설명합니다. API 키 발급부터 Claude Desktop 연동, 흔한 오류 해결까지 완벽 가이드.

기상청 단기예보 API가 MCP 서버를 거쳐 Claude AI에 한국 날씨 정보를 전달하는 흐름을 나타낸 표지 이미지

기상청 단기예보 API를 MCP 서버로 연결하면, Claude와 대화하듯 한국 날씨를 실시간으로 물어볼 수 있습니다. 공공데이터포털에서 무료 API 키를 발급받고, Smithery CLI 명령어 하나로 Korea Weather MCP 서버를 Claude Desktop에 등록하면 됩니다. 이 글에서는 API 키 발급부터 Claude 연동, 흔한 오류 해결까지 전 과정을 단계별로 안내합니다.

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

Claude는 학습 데이터 기준 이후의 실시간 정보를 알지 못합니다. 오늘 서울 날씨, 내일 강수 확률 같은 질문에 정확한 답을 하려면 외부 데이터 소스와의 연결이 필요합니다. MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구·API를 표준화된 방식으로 호출할 수 있도록 Anthropic이 정의한 프로토콜입니다.

기상청이 공공데이터포털(data.go.kr)을 통해 공개한 단기예보 조회서비스는 전국 격자 단위로 기온·강수·풍속 등을 최대 3일치 예보로 제공합니다. 이 API를 MCP 서버로 감싸면 Claude가 자연어 질문만으로 날씨 데이터를 조회하고 요약해 줄 수 있습니다.

사용자 ──▶ Claude Desktop ──▶ Korea Weather MCP 서버 ──▶ 기상청 단기예보 API (data.go.kr)
                                                              │
                                                              ▼
사용자 ◀── Claude (요약·해석) ◀── MCP 응답 ◀── 날씨 JSON 데이터

준비물

항목설명
공공데이터포털 계정data.go.kr 회원가입 (무료)
기상청 단기예보 API 키활용 신청 후 발급 (무료)
Node.js 18 이상npx 명령 실행에 필요
Claude DesktopAnthropic 공식 데스크탑 앱

단계별 설치 방법

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

  1. 기상청 단기예보 조회서비스 신청 페이지에 접속합니다.
  2. 로그인 후 “활용신청” 버튼을 클릭합니다.
  3. 활용 목적을 간단히 기재하고 신청을 완료합니다.
  4. 마이페이지 → 데이터 활용 → 오픈 API에서 일반 인증키(Encoding) 를 확인합니다.

신청 직후에는 키 활성화에 수 분에서 최대 1~2시간이 소요될 수 있습니다. 인증 오류가 나면 잠시 후 다시 시도하세요.

2단계: Korea Weather MCP 서버 설치

터미널을 열고 아래 명령을 실행합니다. Smithery CLI가 자동으로 서버를 내려받고 Claude Desktop 설정에 등록합니다.

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

명령이 완료되면 Claude Desktop의 설정 파일에 서버 항목이 자동으로 추가됩니다.

3단계: API 키를 설정 파일에 등록

자동 설치 후 설정 파일을 직접 열어 API 키를 입력해야 합니다. 설정 파일 위치는 운영체제별로 다릅니다.

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

파일을 텍스트 편집기로 열면 아래와 같은 형태로 서버 항목이 추가되어 있습니다.

{
  "mcpServers": {
    "korea_weather": {
      "command": "...",
      "env": {
        "API_KEY": "여기에_발급받은_인증키를_입력"
      }
    }
  }
}

"여기에_발급받은_인증키를_입력" 부분을 공공데이터포털에서 발급받은 실제 인증키로 교체하고 파일을 저장합니다.

4단계: Claude Desktop 재시작 및 동작 확인

파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 그런 다음 채팅창에 다음과 같이 입력해 보세요.

오늘 서울 날씨 알려줘

Claude가 기상청 단기예보 데이터를 조회해 기온, 강수 확률, 하늘 상태 등을 요약해 준다면 연동이 성공한 것입니다.

5단계: 자연어로 다양한 날씨 질문하기

MCP 서버가 연결되면 아래처럼 자연스러운 문장으로 날씨를 물어볼 수 있습니다.

내일 부산 강수 확률은?
이번 주 제주도 날씨 요약해줘
지금 인천 기온이 몇 도야?

흔한 오류와 해결 방법

오류 증상원인해결 방법
INVALID_API_KEY인증키 오타 또는 미활성화공공데이터포털에서 인증키 재확인, 활성화 대기
GRID_OUT_OF_RANGE격자 좌표 범위 초과유효한 격자 좌표 (nx: 1149, ny: 1253) 사용
MCP 서버 목록에 미표시설정 파일 JSON 오류JSON 형식 검사기로 파일 유효성 확인
응답은 오지만 날씨 정보가 없음API 호출 한도 초과공공데이터포털에서 일일 호출량 확인

JSON 형식을 확인하는 가장 빠른 방법은 설정 파일 내용을 jsonlint.com 같은 온라인 검사기에 붙여 넣는 것입니다. 괄호 하나가 빠지거나 쉼표가 잘못 들어가도 Claude Desktop이 MCP 서버를 인식하지 못합니다.

Korea Weather MCP 서버 상세 정보

Korea Weather MCP 서버는 기상청 단기예보 API를 래핑한 오픈소스 프로젝트입니다. 주요 특징은 아래와 같습니다.

항목내용
저장소github.com/ohhan777/korea_weather
사용 API기상청 단기예보 조회서비스 (data.go.kr)
API 키 필요 여부필요 (공공데이터포털 무료 발급)
설치 방식Smithery CLI (uvx 기반)

날씨 카테고리에서 유사한 MCP 서버를 더 탐색하거나, 전체 서버 목록에서 다른 분야의 한국 API 연동 서버를 확인해 보세요.

자주 묻는 질문

기상청 단기예보 API는 유료인가요?

공공데이터포털(data.go.kr)에서 제공하는 기상청 단기예보 조회서비스는 무료입니다. 회원가입 후 활용 신청을 완료하면 API 키를 무료로 발급받을 수 있습니다. 다만 일일 호출 허용량이 있으므로 과도한 자동 호출은 제한될 수 있습니다.

MCP 서버를 사용하려면 프로그래밍 지식이 필요한가요?

Smithery CLI를 이용하면 단일 명령어로 설치할 수 있어 복잡한 코딩 없이도 설정 가능합니다. 다만 설정 파일(JSON)을 직접 편집해야 하므로 텍스트 파일 수정 정도의 기초 지식은 필요합니다. JSON 구조가 익숙하지 않다면 온라인 검사기를 활용하면 도움이 됩니다.

어떤 날씨 정보를 조회할 수 있나요?

기상청 단기예보 API는 기온, 강수 형태, 강수 확률, 강수량, 적설량, 습도, 풍속, 풍향, 하늘 상태 등의 항목을 최대 3일치 예보로 제공합니다. 시간별 상세 예보도 포함되어 있어 오전/오후 날씨를 구분해 물어보는 것도 가능합니다.

Claude Code나 Cursor에서도 사용할 수 있나요?

네, MCP 프로토콜을 지원하는 Claude Code, Cursor, Continue 등 다양한 클라이언트에서 동일하게 연동할 수 있습니다. 클라이언트마다 설정 파일 위치와 형식이 조금씩 다르므로 각 클라이언트의 공식 MCP 설정 문서를 함께 참고하세요. Claude Desktop 설정 방법은 Claude Desktop MCP 설정 가이드를 참고하세요.

API 키를 발급받은 뒤 바로 사용할 수 있나요?

활용 신청 직후에는 키가 활성화되는 데 수 분에서 최대 1~2시간이 걸릴 수 있습니다. 그 사이에 API를 호출하면 인증 오류가 발생할 수 있으니 잠시 기다린 뒤 시도하세요.

Korea Weather MCP 서버는 전국 어디나 조회할 수 있나요?

기상청 단기예보 API는 격자 좌표 기반으로 전국 지점을 모두 지원합니다. 서울·부산·제주 등 주요 도시뿐 아니라 도서 지방도 격자 좌표만 정확히 지정하면 조회 가능합니다. 기상청 공식 문서에서 지역별 격자 좌표 표를 확인할 수 있습니다.

다음 단계

기상청 MCP 서버 연동에 성공했다면, 이를 응용해 다양한 자동화를 만들어 볼 수 있습니다. 예를 들어 매일 아침 특정 지역의 날씨를 요약해 달라고 하거나, 강수 확률이 높을 때 우산을 챙기라는 알림을 받는 워크플로를 구성할 수 있습니다.

더 많은 한국 공공 API MCP 서버가 궁금하다면 날씨 카테고리나 전체 서버 목록을 둘러보세요. 직접 만든 MCP 서버를 공유하고 싶다면 서버 등록 페이지를 통해 MCP모아에 제출할 수도 있습니다.

이 글과 관련된 MCP 서버