{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_e5b6x7jf2gnf","handle":"oc-korea-weather-time-mcp","url":"https://wellknown.network/agents/oc-korea-weather-time-mcp","links":{"self":"https://wellknown.network/agents/oc-korea-weather-time-mcp/record.json","html":"https://wellknown.network/agents/oc-korea-weather-time-mcp","markdown":"https://wellknown.network/agents/oc-korea-weather-time-mcp/record.md","api":"https://wellknown.network/api/v1/agents/oc-korea-weather-time-mcp","status":"https://wellknown.network/api/v1/agents/oc-korea-weather-time-mcp/status","claim":"https://wellknown.network/agents/oc-korea-weather-time-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/oc-korea-weather-time-mcp/claim.json","badge":"https://wellknown.network/agents/oc-korea-weather-time-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:oc-korea-weather-time-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"oc-korea-weather-time-mcp","summary":"기상청 날씨 + 시간대 조회 MCP 서버 (Korean weather & timezone MCP server)","description":"# oc-korea-weather-time-mcp\n\n기상청 날씨와 시간대 조회를 제공하는 MCP 서버.\n\n```bash\nuvx oc-korea-weather-time-mcp\n```\n\n## 왜 만들었나\n\n- 기존 `korea-weather-mcp` 는 개인 개발자가 2025-09 에 v0.1.0 한 번 올리고 방치했고\n  초단기실황만 지원한다.\n- 자격증명(기상청 서비스 키)을 다루는 물건은 직접 관리한다는 방침.\n- 날씨와 시간은 어차피 같이 쓰인다 — \"내일 아침 서울 날씨\" 를 답하려면 둘 다 필요하다.\n\n## 툴\n\n### 날씨 (기상청 단기예보 조회서비스)\n\n| 툴 | 출처 API | 범위 |\n|---|---|---|\n| `get_current_weather(location=\"\")` | 초단기실황 | 지금 관측값 |\n| `get_hourly_forecast(location=\"\", hours=6)` | 초단기예보 | 앞으로 6시간 |\n| `get_daily_forecast(location=\"\", slots=24)` | 단기예보 | 앞으로 3일 |\n\n`location` 은 지역명(`서울`·`인천`·`부산광역시`), 부분 일치(`성남시 분당구`),\n또는 `위도,경도` 문자열을 받는다. 생략하면 `KMA_DEFAULT_LOCATION`(기본 `서울`).\n모르는 지역이면 오류 응답에 지원 목록을 실어 보낸다 — 목록 전용 툴을 두면\n매 요청 프롬프트에 비용이 붙기 때문이다.\n\n강수확률(`POP`)과 일최저/최고기온은 **단기예보에만** 있다.\n\n### 시간\n\n| 툴 | 하는 일 |\n|---|---|\n| `get_current_time(timezone=\"Asia/Seoul\")` | 지정 시간대의 현재 시각 |\n| `convert_time(time, from_timezone, to_timezone)` | 시간대 간 변환 |\n| `find_timezone(query)` | IANA 시간대 이름 검색 |\n\n시간 쪽은 파이썬 표준 `zoneinfo` 만 쓴다. 외부 의존이 없다.\n\n## 설정\n\n```bash\nexport KMA_SERVICE_KEY=\"발급받은-디코딩-키\"    # 날씨 툴에 필수\nexport KMA_DEFAULT_LOCATION=\"서울\"             # 선택\n```\n\n서비스 키는 [공공데이터포털](https://www.data.go.kr) → `기상청_단기예보 조회서비스`\n활용신청 → **일반 인증키(Decoding)**. 인코딩 키(`%2B` 가 섞인 것)를 넣으면\n이중 인코딩으로 인증에 실패한다.\n\n**키는 환경변수로만 받는다.** `httpx` 가 INFO 레벨에서 요청 URL 전체를 찍는데\n쿼리스트링에 `serviceKey` 가 들어 있어 키가 로그에 평문으로 남는다.\n그래서 `httpx`·`httpcore` 로거를 WARNING 으로 낮춘다.\n\n### 한쪽만 쓰기\n\n툴 정의는 매 요청마다 프롬프트에 실린다. 필요 없는 쪽은 끄면 그만큼 가벼워진다.\n\n```bash\nexport OC_KOREA_MCP_TIME=0        # 날씨 툴 3개만\nexport OC_KOREA_MCP_WEATHER=0     # 시간 툴 3개만\n```\n\n## 등록\n\n```bash\n# Claude Code\nclaude mcp add oc-korea-weather-time \\\n  -e KMA_SERVICE_KEY=발급받은-키 \\\n  -- uvx oc-korea-weather-time-mcp\n\n# Hermes\nhermes mcp add oc-korea-weather-time \\\n  --command uvx --args oc-korea-weather-time-mcp \\\n  --env KMA_SERVICE_KEY=발급받은-키\n```\n\n## 설계 메모\n\n- **격자 변환** — 기상청 API 는 위경도를 안 받고 자체 격자(nx, ny)를 쓴다.\n  Lambert Conformal Conic 투영, 파라미터는 기상청 고시값.\n  서울(60,127)·부산(98,76)·제주(53,38) 표준 검증값과 일치를 확인했다.\n- **코…","publisher":{"name":"jshsakura","url":null},"homepage":"https://github.com/jshsakura/oc-korea-weather-time-mcp","repository":"https://github.com/jshsakura/oc-korea-weather-time-mcp","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["kma","korea","mcp","model-context-protocol","timezone","weather","기상청"],"pricing":null,"endpoints":[{"url":"pypi:oc-korea-weather-time-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.weather","name":"Weather","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"oc-korea-weather-time-mcp","registry":"pypi","observedAt":"2026-09-10T08:27:32.265Z","publishedAt":"2026-08-11T06:05:10.755019Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"oc-korea-weather-time-mcp","url":"https://pypi.org/project/oc-korea-weather-time-mcp/","firstSeenAt":"2026-09-10T08:25:59.718Z","fetchedAt":"2026-09-10T08:25:59.718Z","normalizedAt":"2026-09-10T08:25:59.718Z"}]},"firstSeenAt":"2026-09-10T08:25:59.718Z","updatedAt":"2026-09-10T08:27:32.265Z"}