Testing¶

uv run pytest                      # unit + conformance, no network (about 350 tests, a few seconds)
uv run pytest --cov=neon_mcp       # with coverage (95 % at 0.1.0)
NEON_MCP_LIVE=1 NEON_TOKEN=... uv run pytest -m live tests/live   # against the real API

Hermetic by default¶

Unit tests never touch the network. tests/fixture_router.py is an httpx.MockTransport handler over tests/fixtures/ (real NEON responses recorded on 2026-09-10, shrunk and scrubbed; see tests/fixtures/MANIFEST.md). It replays NEON's rate-limit headers, answers token endpoints with NEON's real 403 when X-API-Token is missing, records every call (tests assert call counts, cache hits and that tokens never reach storage hosts) and fails the test on any unrouted request. Sleeps and clocks are injected, so retries and rate limits run instantly.

Layout¶

Path	Covers
`tests/test_*.py`	config, errors, redaction, registry and budget, adapter, CLI, resources, prompts, conformance
`tests/neon/`	client, rate limiter, cache, auth, months, catalog, resolution, GraphQL guard, file names, download manager
`tests/tools/`	every tool family through `call_ok` / `call_err` (results validated against `outputSchema`)
`tests/transport/`	Streamable HTTP app, health checks, token passthrough, a real stdio subprocess in both protocol eras

CI¶

.github/workflows/ci.yml runs ruff, mypy --strict, pytest with coverage and the fixture scrub check on Python 3.11–3.13, a macOS subset, a separate MCP 2026-07-28 conformance job (SDK major version, deprecated-feature grep), and nightly live tests. .github/workflows/docs.yml validates the OKF bundle, checks that generated docs are current, builds the site and deploys it.