# Pregnancy Official Source Navigator

This repository contains a metadata-only Remote MCP server for navigating verified Korean
pregnancy and childbirth sources. It exposes exactly five tools. Four tools return curated
official-source metadata and links; `find_hospitals` returns bounded HIRA directory facts by
full administrative region. It does not summarize source content or provide medical advice.

## Local development

Prerequisites are `uv` and a Docker runtime capable of building `linux/amd64` images.

```sh
uv lock --check
uv sync --locked --extra dev
uv run pytest -q
uv run ruff check .
uv run basedpyright
```

Production startup requires the nonblank Public Data Portal key `DATA_GO_KR_KEY` before the
process binds. All `data.go.kr` APIs use this single operator-provided key; service-specific key
aliases are not accepted. Supply it through an ignored local environment file or the operator's
secret manager. Never place a key, cookie, authentication material, private service location, or
personal information in this repository or its evidence files.

## Local Docker candidate

```sh
docker build --platform linux/amd64 -t pregnancy-mcp:local .
docker build -t pregnancy-mcp:local .
uv run python scripts/smoke_candidate.py \
  --image pregnancy-mcp:local \
  --host-port 18000 \
  --output evidence/playmcp/local-candidate.md
```

The smoke owns its exact containers, loopback port, temporary environment file, exported
rootfs, archive, and extraction directory. It calls only a local catalogue tool and an invalid
input case; it never calls HIRA with its synthetic startup value. The named local image remains
for final verification.

Detailed local inspection and cleanup steps are in
[`docs/deployment-runbook.md`](docs/deployment-runbook.md).

## External status boundary

The local image and reports are not KC deployment, PlayMCP registration, review approval,
public visibility, logged-out access, or BizForm submission evidence. Those external actions
remain pending until an authorized operator has the required signed-in session, credentials,
and repository-relative redacted evidence. This repository does not perform them automatically.