# Dolbom Navi MCP

`Dolbom Navi(돌봄내비)` is a PlayMCP-compatible remote MCP server for Korean family senior-support navigation.

It helps families route elderly-care questions across welfare, medical support, mobility, long-term care, dementia support, facilities, and local administration using official-source guidance.

Core scenario tools cover:

- broad family-care situation analysis
- official support-route routing
- local support contact discovery
- long-term-care path explanation
- dementia care checklist
- urgent safety triage
- care/facility option comparison
- care service type explanation
- institution call-script preparation
- optional family-share summaries

## PlayMCP Fit

- Streamable HTTP transport: `POST /mcp`
- Stateless server
- Tool count: 10
- No `kakao` string in server or tool names
- Official-source registry exposed as a resource
- Dockerfile included for PlayMCP in KC Git source build

## Run Locally

```bash
npm install
npm run build
npm start
```

Health check:

```bash
curl http://127.0.0.1:3000/healthz
```

MCP endpoint:

```text
http://127.0.0.1:3000/mcp
```

For a public deployment, set `MCP_ALLOWED_HOSTS` to the comma-separated hostnames that should be accepted in the HTTP `Host` header. Example:

```bash
MCP_ALLOWED_HOSTS=127.0.0.1,localhost,your-playmcp-host.example.com npm start
```

## Smoke Test

Start the server in one terminal:

```bash
npm start
```

Run the Streamable HTTP smoke test in another terminal:

```bash
MCP_ENDPOINT=http://127.0.0.1:3000/mcp npm run smoke
```

`MCP_ENDPOINT` is required on purpose. This avoids accidentally testing another
service that happens to be running on port 3000.

For LLM-connected evaluation, provide both the OpenRouter key and the exact MCP
endpoint being reviewed:

```bash
OPENROUTER_API_KEY=... MCP_ENDPOINT=http://127.0.0.1:3000/mcp npm run llm:eval
```

## Inspector

```bash
npm run inspect
```

For repeatable CLI checks while the server is running:

```bash
npm run inspect:tools
npm run inspect:resources
npm run inspect:source-registry
```

## Deploy With PlayMCP In KC

Use the Git source build path:

- Git URL: `https://github.com/hjongc/dolbom-navi-mcp`
- Branch/ref: `main`
- Dockerfile path: `Dockerfile`
- PAT: empty if the repository is public

After PlayMCP in KC returns an Endpoint URL, register it in the PlayMCP developer console and test as a temporary registration before requesting review.

Before review, run both checks against the returned endpoint:

```bash
MCP_ENDPOINT=https://your-server.playmcp-endpoint.kakaocloud.io/mcp npm run smoke
OPENROUTER_API_KEY=... MCP_ENDPOINT=https://your-server.playmcp-endpoint.kakaocloud.io/mcp npm run llm:eval
```

## Official Source Categories

The server uses curated official/public-agency source records:

- 국민건강보험공단 노인장기요양보험
- 정부24
- 복지로
- 보건복지부
- 중앙치매센터
- 중앙치매센터 치매상담콜센터
- 응급의료포털 E-Gen
- 거주지 시·군·구청 공식 누리집
- 광역 교통약자 이동지원센터 대표번호 레지스트리
- 119
- 경찰청 112

The server does not diagnose dementia, determine long-term care grade eligibility, guarantee benefits, rank facilities from unverified reviews, or collect resident registration numbers, exact addresses, phone numbers, payment details, or medical records.