KMA Weather MCP Server

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)"
      }
    }
  }
}

주의: args의 마지막 경로는 실제 server.py가 위치한 절대 경로로 수정해야 합니다.

Development

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