Korea Weather MCP Server
본 MCP 서버는 기상청 단기예보 조회서비스 API를 기반으로 동작하는 MCP 서버입니다.
소개
Korea Weather MCP Server는 기상청의 날씨 정보를 수집하여, MCP 프로토콜을 통해 Claude나 Cursor와 같은 MCP 클라이언트(Host)에 제공합니다.
이 서버는 기상 정보를 활용하는 다양한 응용 서비스에 쉽게 연동될 수 있습니다.
주요 기능
- 기상청 단기예보 API 연동
- MCP 형식의 기상 정보 제공
설치 및 사용 방법
Smithery를 이용한 간편 설치
- data.go.kr에서 기상청 단기예보 API를 신청하고 API 키를 발급받습니다.
- 다음 명령어를 사용해 Smithery에서 서버를 설치하고 Claude Desktop에 등록합니다.
설치 과정에서 API 키 입력을 요구하면 발급받은 키를 입력합니다.npx -y @smithery/cli install @ohhan777/korea_weather --client claude
- Claude Desktop을 재시작하여 사용하면 됩니다.
Github에서 직접 설치하는 방법
-
data.go.kr에서 기상청 단기예보 API 활용 신청 후 API 키를 발급받습니다.
-
github에서 소스코드를 다운받아 실행해봅니다.
git clone https://github.com/ohhan777/korea_weather.git cd korea_weather uv run korea_weather.py -
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!" } } } }
-
프롬프트 예제
>> 제주 국제 공항 현재 날씨를 알려줘.
>> 내일 오후에 서울 남대문에 놀러가려고 하는데 우산을 챙겨야할까?
>> 오늘 오후에 세차하기에 괜찮은 날씨일까?
의존성
pyproject.toml 참고
라이선스
본 프로젝트는 내부 시험용으로 개발되었으며, 별도의 라이선스 규정 없이 자유롭게 배포 및 수정이 가능합니다.
문의
개발자: 한국항공우주연구원 오한 (ohhan@kari.re.kr)
Metadata
Release files for iflow-mcp_ohhan777_korea-weather 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_ohhan777_korea_weather-0.1.1.tar.gz | 8.4 kB | Without provenance | Details for iflow_mcp_ohhan777_korea_weather-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_ohhan777_korea_weather-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_ohhan777_korea_weather-0.1.1-py3-none-any.whl |
Total release size: 17.2 kB
Release files / iflow_mcp_ohhan777_korea_weather-0.1.1.tar.gz
| Download URL | iflow_mcp_ohhan777_korea_weather-0.1.1.tar.gz |
|---|---|
| Size | 8.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d3474c40bc784e7390fa7e93ab348ffe6bde68d4e307d1ce37c091598f1a650
|
|
BLAKE2b-256 checksum How to use checksums |
969a88e4d669b3385ae53c8793d4ed56bd3d3966ba6a13db09c2f79f14f93bed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_ohhan777_korea_weather-0.1.1-py3-none-any.whl
| Download URL | iflow_mcp_ohhan777_korea_weather-0.1.1-py3-none-any.whl |
|---|---|
| Size | 8.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0150699c8145df14cc68cf9a2bf3dcfcaf64099ea367e687c6a5fa03887faed9
|
|
BLAKE2b-256 checksum How to use checksums |
b06f44282068d405da53896b541a6b771559e90871ea433ce01f648a7ab5383d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_ohhan777_korea-weather 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.