Physics Worksheet MCP

An authenticated MCP service that selects questions from administrator-installed immutable bank releases and renders source-bound PDFs using XeLaTeX. Question banks are private, separately supplied data; this repository includes only original synthetic engineering fixtures.

Python 3.12 (64-bit), SQLite FTS5 and XeLaTeX with ctexart are required. Windows can run non-TeX tests; use Linux/WSL for rendering.

uv sync --locked
uv run pytest
uv run python scripts/make_demo.py
uv run pwmcp serve --config deploy/config.example.toml
# A second terminal, from the same working directory:
uv run pwmcp worker --config deploy/config.example.toml

Use the administrator CLI to create users, grant banks and issue token files. Run pwmcp admin --help. No administrative tools are exposed through MCP. The endpoint is /mcp; health endpoints are /healthz and /readyz.

Only deterministic filters and completed scope reviews establish coverage within their scope. Search always reports coverage: partial. Zero matches produce no job or PDF. Shortfalls are explicit. Content and answers always come from validated server-side packages.

See tools, deployment, clients and provenance. Source is available under AGPL-3.0-or-later; data rights and teaching quality remain separate from engineering validation.