地下水mcp
一个开源的Python MCP服务器，用于使用MODFLOW 6、FloPy、PEST++、pyEMU和UCODE进行人工智能辅助地下水建模。
没有候补名单。没有付费墙。无封闭组件。完全在您的机器上运行。
______________________________________________________________________
它做什么
地下水mcp将任何兼容mcp的AI助手（Claude、Cursor等）连接到完整的地下水建模堆栈。你可以让你的人工智能从现实世界的数据中构建一个模型，运行它，检查结果，校准参数——所有这些都是通过自然语言完成的，实际的计算是通过FloPy和MODFLOW 6在本地进行的。
"I have a DEM raster, a shapefile of geological zones with K values,
borehole water level CSVs, and a river centreline shapefile.
Build a 3-layer transient model of the catchment, run it for 2 years,
calibrate against the observed heads, and plot the water balance."范围
地下水mcp覆盖 *建模* 地下水工作流程的侧面：根据处理后的空间数据对模型进行参数化、运行模拟、后处理结果和校准参数。
上游数据准备——剪切DEM、克里格钻孔记录、处理气候数据——故意超出范围。那项工作应该交给同伴 geodata-mcp （计划中）。两者之间的接口很简单：地下水mcp接受标准文件格式（GeoTIFF、GeoPackage/Shapefile、CSV）作为其参数化工具的输入。
______________________________________________________________________
工具（共36个）
| 模块 | 工具 |
|---|---|
| 文档 | search_docs, search_tutorials, get_doc_file |
| 参数化 | import_grid_from_shapefile, assign_top_from_raster, assign_k_from_zones, import_river_from_shapefile, import_obs_from_csv |
| 模型构建器 | create_model, set_simulation, add_dis_package, add_disv_package, add_npf_package, add_ic_package, add_boundary_package, add_oc_package, summarise_model, list_model_files |
| 跑步者 | check_model, run_simulation, get_run_log |
| 后处理 | read_heads, read_budget, compute_drawdown, compute_water_balance, plot_heads_map, plot_cross_section |
| 校准（PEST++） | setup_pest_control, run_pestpp_glm, run_pestpp_ies, summarise_calibration, run_ies_uncertainty |
| 校准（UCODE） | setup_ucode_control, run_ucode, summarise_ucode_calibration, run_ucode_uncertainty |
看 TOOLS.md 用于完整的输入/输出文档。
______________________________________________________________________
安装
# 1. Install the package
pip install groundwater-mcp
# 2. Download MODFLOW 6 binary
get-modflow :
# 3. Download PEST++ binaries (for calibration)
get-pestpp :
# 4. Build the local docs search index
groundwater-mcp build-indexClaude桌面配置
添加 ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"groundwater": {
"command": "groundwater-mcp",
"args": ["serve"]
}
}
}______________________________________________________________________
需求
- Python 3.11+
- 浮萍≥3.7
- geopandas、rasterio（用于参数化工具）
- MODFLOW 6二进制（通过
get-modflow) - pyemu（用于PEST++校准工具）
- PEST++二进制文件（用于PEST++校准工具）
- UCODE_2014二进制文件（适用于UCODE校准工具；从下载https://geology.mines.edu/igwmc/ucode/)
______________________________________________________________________
项目文件
______________________________________________________________________
许可证
麻省理工学院——见 许可证.
______________________________________________________________________