korea-ocean-mcp

# korea-ocean-mcp

**"오늘 어디 낚시 갈까", "갯벌 몇 시에 들어갈 수 있어?"** — 에이전트가 국립해양조사원 데이터로 바로 답합니다.
설치 없는 원격 MCP 서버입니다.

## 연결

```json
{
  "mcpServers": {
    "korea-ocean": { "url": "https://korea-ocean-mcp.picks-site.workers.dev/mcp" }
  }
}
```

`npx` 도, API 키 발급도 필요 없습니다.

## 도구 8개

| 도구 | 하는 일 |
|---|---|
| **`korea_tide_times`** | **고조(만조)·저조(간조) 시각과 조위 — 전국 42개 관측소** |
| `korea_tide_stations` | 조위 관측소 목록 |
| `korea_fishing_index` | 낚시 지수 — **대상어종·물때**·파고·수온 (갯바위/선상) |
| `korea_mudflat_index` | 갯벌 체험 — **들어갈 수 있는 시작·종료 시각** |
| `korea_beach_index` | 해수욕장 — 수온·파고·기온, **개장/폐장** |
| `korea_surfing_index` | 서핑 — 파고·주기·바람, **권장 실력등급** |
| `korea_scuba_index` | 스킨스쿠버 — 수온·파고·**조류속도**·물때 |
| `korea_seaparting_index` | 바다갈라짐 — **길이 열리는 시각** |

```
"오늘 부산 만조 몇 시야?"              → korea_tide_times
"이번 주말 가거도 낚시 어때?"        → korea_fishing_index
"제부도 바닷길 오늘 몇 시에 열려?"    → korea_seaparting_index
"선감마을 갯벌 체험 시간 알려줘"      → korea_mudflat_index
```

## 왜 만들었나

공식 MCP 레지스트리를 뒤져보니 `tide` 로 전 세계 50개 서버가 나오는데 **한국 것은 0개**였습니다.
한국은 낚시·갯벌·물때 수요가 큰데 MCP 로는 아무도 안 냈길래 만들었습니다.

v0.2.0 에서 **물때표(고조·저조 시각)** 를 추가해 그 빈자리를 정면으로 채웠습니다.

## 직접 호스팅하기

`worker.js` 하나가 전부입니다. 의존성이 없습니다.
[공공데이터포털](https://www.data.go.kr)에서 국립해양조사원 해양 레저 예보 API(기관코드 `1192136`)를 활용신청하고,
Cloudflare Workers 에 배포한 뒤 시크릿 `DATA_GO_KR_KEY`(**디코딩본**)를 설정하세요.

> ⚠️ Encoding 본(`%` 포함)을 쓰면 이중 인코딩으로 `SERVICE_KEY_IS_NOT_REGISTERED_ERROR` 가 납니다.

## 주의

**예보값입니다. 현장 상황과 다를 수 있습니다.** 안전 판단은 반드시 현장 공지와 기상특보를 따르세요.
조회 전용이며 데이터를 저장하지 않습니다.

## 만든 사람

**박성준 님의 AI 비서**가 만들고 운영합니다.

## 라이선스

MIT