Skip to main content
Glama

KMA Weather MCP Server

대한민국 기상청(KMA) 단기예보 Open API를 연결하는 Model Context Protocol (MCP) 서버입니다.

Features

Resources (자원)

  • weather://seoul/now: 서울(시청)의 현재 날씨 데이터를 조회합니다.

  • weather://{latitude}/{longitude}/now: 입력한 위도/경도 위치의 현재 날씨를 조회합니다.

Tools (도구)

  • get_ultra_short_term_forecast: 향후 6시간의 초단기 예보를 조회합니다. (강수확률, 하늘상태 등)

  • get_village_forecast: 오늘부터 모레까지의 단기 예보를 조회합니다.

Configuration (설정)

1. API Key 발급

공공데이터포털에서 '기상청_단기예보 조회서비스' 활용신청을 하고 **일반 인증키(Decoding)**를 발급받으세요.

2. 환경 변수 설정

프로젝트 루트 .env 파일에 키를 저장합니다:

KMA_API_KEY_DECODED=your_decoding_key_here

3. Claude Desktop 설정 (claude_desktop_config.json)

Claude Desktop 앱에서 이 서버를 사용하려면 설정 파일을 수정해야 합니다.

경로:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

설정 내용:

{ "mcpServers": { "kma-weather": { "command": "uv", "args": [ "run", "-q", "--with", "mcp[cli]", "--with", "httpx", "--with", "fastmcp", "--with", "python-dotenv", "/ABSOLUTE/PATH/TO/Public API to MCP Converter Agent/kma-weather-mcp/src/server.py" ], "env": { "KMA_API_KEY_DECODED": "YOUR_KEY_HERE (Optional if using .env file in project dir)" } } } }

주의:

Development

# Run server using default MCP Inspector npx @modelcontextprotocol/inspector uv run src/server.py

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/woongaro/KMA-WEATHER-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server