Skip to content
Tresca

pyHMT2D MCP server

MCP serverCommunity

pyHMT2D's MCP server opens, edits, runs and post-processes HEC-RAS 2D and SRH-2D projects. By psu-efd (Penn State).

134 starsUpdated 3 months agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
HEC-RAS
How it connects
Drives a running copy of the tool
Access
Can modify models
Tool versions
HEC-RAS 6.6 (RAS 2025 not supported); SRH-2D 3.3, 3.6 and 3.7
Operating systems
Windows
Needs a HEC-RAS licence
No
Transport
Local (stdio)
AI clients documented
Claude Code, Codex, Cursor, Windsurf
Licence
MIT
Language
Python

What it can do

  • Inspects projects, including materials, Manning's n values and boundary conditions.
  • Edits Manning's n, inlet flow and exit water surface elevation, then runs the simulation.
  • Queries results and exports them to VTK for ParaView, and converts HEC-RAS 2D meshes to SRH-2D.
  • Runs automated Manning's n calibration and Monte Carlo uncertainty analysis.

Limitations

  • Windows only in practice, because HEC-RAS 2D and SRH-2D are Windows programs; Linux has limited testing.
  • 1D channels, hydraulic structures, sediment and water quality are not processed.
  • Controls HEC-RAS through its COM interface; a stale pywin32 cache after reinstalling HEC-RAS needs clearing.

Install

pip install pyHMT2D[ai]

Source: github.com/psu-efd/pyHMT2D#installation-option-2-install-from-pypi-library-only-no-examples

MCP servers and skills run code on your computer. Review the source before installing.

Skills that come with it

SkillCommunity

pyHMT2D agent skillsby psu-efd (Penn State)

Slash-command skills such as /hmt-open, /hmt-run and /hmt-calibrate that sequence pyHMT2D's MCP tools.

Windows134· updated 3 months ago

AI-generated models, drawings and results must be checked by a qualified engineer before use.