# 한국 생활 조회 MCP

Hosted `k-skill-proxy` REST endpoints wrapped as a read-only Model Context Protocol server for PlayMCP in KC.

## 등록 도구

- `search_subway_arrivals`
- `check_fine_dust`
- `forecast_korea_weather`
- `check_han_river_water_level`
- `check_seoul_bike_nearby`
- `check_seoul_density`
- `check_seoul_bike_realtime`
- `resolve_real_estate_region_code`
- `search_real_estate_apartment_trade`
- `search_real_estate_apartment_rent`
- `check_household_waste_info`
- `search_lh_notices`
- `search_korean_law`
- `get_korean_law_detail`
- `lookup_drug_safety`
- `search_food_safety`
- `search_libraries`
- `search_books`
- `search_neis_schools`
- `get_neis_school_meal`

공모전 등록 제한에 맞춰 20개 핵심 조회 도구만 MCP에 등록합니다. 카카오 지역 검색,
KOSIS, 사업·창업, 주식, 쇼핑·뉴스 도구는 등록하지 않습니다.

## Local

```bash
npm ci
npm run build
PORT=8000 npm start
```

MCP endpoint:

```text
http://127.0.0.1:8000/mcp
```

## PlayMCP in KC Git Source Build

- MCP 서버 이름: `korea-life-lookup`
- 설명: `한국 생활 조회 MCP는 날씨, 교통, 주거, 법·안전, 도서관·학교 데이터를 조회합니다.`
- Git URL: this repository HTTPS URL
- 브랜치 / ref: `main`
- Dockerfile 경로: `Dockerfile`
- PAT: public repository이면 비움
- 환경변수: `KSKILL_PROXY_BASE_URL=https://k-skill-proxy.nomadamas.org`
- 컨테이너 포트: `8000`