gms-vmod-grapher-mcp
MCP serverCommunity
Builds, edits and runs MODFLOW models from GMS and Visual MODFLOW with FloPy, and plots results in Grapher. By chenzy0355.
0 starsUpdated 4 weeks agoGitHub data from 5 Nov 2026
At a glance
- Type
- MCP server
- Works with
- MODFLOW / GMS
- How it connects
- Reads and writes files; the tool isn't needed
- Access
- Can modify models
- Tool versions
- Example config uses GMS 10.4, Visual MODFLOW 4.0 and Grapher 16; 16 engines including MODFLOW-2000, 2005, NWT and MF6
- Operating systems
- Windows
- Needs a MODFLOW / GMS licence
- Yes
- Transport
- Local (stdio)
- AI clients documented
- Claude Desktop, Cursor, Cline, VS Code
- Licence
- MIT
- Language
- Python
What it can do
- Reads and writes standard MODFLOW files with FloPy and runs the USGS engines shipped with GMS and Visual MODFLOW, without opening either interface.
- Edits arrays and boundary conditions, then extracts heads, drawdown and water budgets.
- Checks models and parses listing files for convergence, dry cells and mass balance error.
- Fits Theis and Cooper-Jacob curves to pumping test data and drives Grapher through Scripter to produce plots.
Limitations
- GMS projects must first be exported from the interface to MODFLOW text files.
- The README is in Chinese, with an English version alongside.
- Windows only; the GMS, Visual MODFLOW and Grapher installs come from your own licences.
Install
git clone https://github.com/chenzy0355/gms-vmod-grapher-mcp.git
cd gms-vmod-grapher-mcp
python -m venv .venv
.venv\Scripts\python.exe -m pip install -e .{
"mcpServers": {
"gms-vmod-grapher": {
"command": "C:\\path\\to\\gms-vmod-grapher-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "mfmcp.server"],
"env": {
"PYTHONPATH": "C:\\path\\to\\gms-vmod-grapher-mcp\\src",
"PYTHONIOENCODING": "utf-8",
"PYTHONUTF8": "1"
}
}
}
}MCP servers and skills run code on your computer. Review the source before installing.
AI-generated models, drawings and results must be checked by a qualified engineer before use.