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.

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

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.

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.