Korea Weather MCP Server

by ohhan777

11 stars

206 downloads

Not rated

GitHub

Media

About

MCP server using the Korea Weather Service (KWS)

Details

Author: ohhan777
GitHub stars: 11
Downloads: 206
Categories: Media

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Korea Weather MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

From the repository

Obtain an API key from data.go.kr for the 단기예보 API, then install via Smithery (npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude) or clone the repository, set the KOREA_WEATHER_API_KEY environment variable, and configure your MCP client. Run locally with uv run korea_weather.py or uv run smithery dev for HTTP mode on port 8081.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "korea weather mcp server": {
            "korea_weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "mcp",
                    "add",
                    "ohhan777/korea_weather",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "korea_weather": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "mcp",
            "add",
            "ohhan777/korea_weather",
            "--client",
            "claude"
        ]
    }
}

Korea Weather MCP Server

본 MCP 서버는 기상청 단기예보 조회서비스 API를 기반으로 동작하는 MCP 서버입니다.

소개

Korea Weather MCP Server는 기상청의 날씨 정보를 수집하여, MCP 프로토콜을 통해 Claude나 Cursor와 같은 MCP 클라이언트(Host)에 제공합니다.
이 서버는 기상 정보를 활용하는 다양한 응용 서비스에 쉽게 연동될 수 있습니다.

MCP Example

주요 기능

- 기상청 단기예보 API 연동
- MCP 형식의 기상 정보 제공

설치 및 사용 방법

Smithery를 이용한 설치

1. data.go.kr에서 기상청 단기예보 API를 신청하고 API 키를 발급받습니다.
2. 다음 명령어를 사용해 Smithery에서 서버를 설치하고 Claude Desktop에 등록합니다.
설치 과정에서 API 키 입력을 요구하면 발급받은 키를 입력합니다.

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

3. Claude Desktop을 재시작하여 사용하면 됩니다.

로컬 개발 (Smithery CLI)

1. 소스코드를 클론하고 의존성을 설치합니다.

   git clone https://github.com/ohhan777/korea_weather.git

   cd korea_weather

   uv sync

2. 환경변수에 API 키를 설정합니다.

   export KOREA_WEATHER_API_KEY="발급받은_API_키"

3. 개발 서버를 실행합니다.

# HTTP 모드로 실행 (http://localhost:8081) uv run smithery dev

# 또는 Smithery Playground로 대화형 테스트 uv run smithery playground

GitHub에서 직접 설치하는 방법

1. data.go.kr에서 기상청 단기예보 API 활용 신청 후 API 키를 발급받습니다.
2. github에서 소스코드를 다운받아 실행해봅니다.

   git clone https://github.com/ohhan777/korea_weather.git

   cd korea_weather

   uv sync

   uv run korea_weather.py

3. MCP 클라이언트(Host)에 서버를 등록합니다.

- Claude Desktop의 설정 파일은 보통 아래 경로에 위치합니다.
C:\Users\[사용자 이름]\AppData\Roaming\Claude\claude_desktop_config.json
(파일이 없다면 새로 생성)

- Cursor의 경우: 상단의 톱니바퀴 아이콘 → MCP → Add new global MCP server 선택

아래 예시와 같은 형식으로 설정 파일을 작성합니다. (디렉토리 경로와 API 키는 환경에 맞게 수정)

   {
     "mcpServers": {
       "korea_weather": {
         "command": "uv",
         "args": [
           "--directory",
           "C:\\ai\\PyProjects\\korea_weather",
           "run",
           "korea_weather.py"
         ],
         "env": {
           "KOREA_WEATHER_API_KEY": "Input Your API Key Here!"
         }
       }
     }
   }

Smithery에 배포하기

GitHub에 코드를 푸시한 후, smithery.ai/new에서 GitHub 저장소를 연결하면 Smithery가 자동으로 서버를 빌드하고 호스팅합니다.

프롬프트 예제

>> 제주 국제 공항 현재 날씨를 알려줘.
>> 내일 오후에 서울 남대문에 놀러가려고 하는데 우산을 챙겨야할까?
>> 오늘 오후에 세차하기에 괜찮은 날씨일까?

의존성

pyproject.toml 참고

라이선스

본 프로젝트는 내부 시험용으로 개발되었으며, 별도의 라이선스 규정 없이 자유롭게 배포 및 수정이 가능합니다.

문의

개발자: 한국항공우주연구원 오한 (ohhan@kari.re.kr)

수정 이력

- 2026-02: Smithery v4 연동 — smithery dev/smithery playground 로컬 개발 지원, create_server() 팩토리 패턴 도입 - 2026-02: 서버 구조를 리팩터링하고(공통 API 요청 처리, 좌표 변환 캐시), MCP 도구 설명을 보강했습니다. - 2026-02: httpx/dotenv 미설치 환경에서도 동작하도록 표준 라이브러리 기반 HTTP fallback 경로를 추가했습니다. - 2026-02: 오프라인 환경에서도 실행 가능한 단위 테스트(tests/test_korea_weather.py)를 추가했습니다.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Korea Weather MCP Server

소개

주요 기능

설치 및 사용 방법

Smithery를 이용한 설치

로컬 개발 (Smithery CLI)

GitHub에서 직접 설치하는 방법

Smithery에 배포하기

프롬프트 예제

의존성

라이선스

문의

수정 이력

Install

More like this

Google Maps

BlenderMCP

AWS MCP Servers

Figma Context (Framelink)

KiCAD-MCP-Server

DaVinci Resolve MCP Server