# KMA Weather MCP Server

대한민국 기상청(KMA) [단기예보 Open API](https://www.data.go.kr/data/15084084/openapi.do)를 연결하는 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 발급

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

### 2. 환경 변수 설정

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

```bash
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`

**설정 내용:**

```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

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