hecras-mcp
MCP serverCommunity
Runs HEC-RAS 7.0 headless on Windows: inspects projects, computes plans and reads 1D and 2D HDF results. By Oscar Daniel Montero Miranda.
0 starsUpdated 8 weeks 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 7.0.x
- Operating systems
- Windows
- Needs a HEC-RAS licence
- No
- Transport
- Local (stdio)
- AI clients documented
- Claude Code, Claude Desktop
- Licence
- MIT
- Language
- Python
What it can do
- Nineteen tools to find projects and read plans, geometry, cross sections, flow files and 2D flow areas.
- Computes plans with Ras.exe -c and a mandatory timeout, judging success from the plan HDF rather than the exit code.
- Reads results, time series and 2D results from HDF5 with h5py, and builds 2D terrain from a GeoTIFF.
- Checks a plan before computing, including the Spanish regional date format that breaks the engine.
Limitations
- Geometry authoring, hydrograph editing, bridges, sediment, water quality and RAS Mapper inundation mapping are not covered.
- The only edit tool sets steady discharges; it writes a .bak copy first.
- Code comments and the full technical notes are in Spanish.
Install
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
claude mcp add hecras --scope user "C:\path\to\hecras-mcp\start_hecras_mcp.cmd"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.