mfai-viewer

The writer behind the open_in_viewer tool of the MODFLOW AI MCP (https://mcp.modflow.ai). It turns a MODFLOW 6 simulation that was built with FloPy and run on this machine into the snapshot the MODFLOW AI web viewer (viewer.modflow.ai) reads, and uploads that snapshot to the link the MCP tool created.

python -m pip install mfai-viewer
mfai-viewer snapshot --workdir <model dir> --out <snapshot dir>
mfai-viewer upload <snapshot dir> "<uploads url from open_in_viewer>"
mfai-viewer version

snapshot refuses a model that has not been run (no head file). It writes manifest.json and a small summary.json; the MCP tool takes the summary and answers the one upload command to run. upload sends every file in parallel, retries, marks the link complete and prints the URL.

Exit codes: 0 done, 2 the environment cannot run it (Python older than 3.10, missing packages, bad arguments), 3 the model has not been run, 4 files are still missing after the upload, 1 anything else.

The writer code (mfai_viewer/writer) and the GWlink slice it vendors (mfai_viewer/gwlink) are copied byte for byte from the mfai-chat and gwlink repositories; mfai_viewer/sources.json records the commits and the sha256 of every file. Nothing is edited here.