Skip to content
Tresca

RAS Commander MCP

MCP serverCommunity

A read-only MCP server that answers bounded questions from HEC-RAS project and plan text files. By CLB Engineering (gpt-cmdr).

16 starsUpdated 4 days agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
HEC-RAS
How it connects
Reads and writes files; the tool isn't needed
Access
Read-only
Tool versions
Reads HEC-RAS text files through ras-commander 0.104.0 or later (version 0.4.0)
Operating systems
Windows, macOS, Linux
Needs a HEC-RAS licence
No
Transport
Local (stdio)
AI clients documented
Claude Code, Claude Desktop
Licence
MIT
Language
Python

What it can do

  • Reports project length units, plan descriptions and selected project and plan metadata.
  • Reads only from project roots you list in RAS_MCP_ALLOWED_ROOTS; nothing is trusted by default.
  • Opens files beyond the Windows 260-character path limit through extended-length paths.
  • Designed to run inside a subagent that returns compact answers with source file and versions.

Limitations

  • Doesn't run HEC-RAS, modify projects, read HDF or DSS results or inspect geometry; those tasks go through the ras-commander Python library instead.
  • The author recommends exposing its tools only to an isolated subagent, which needs host support.
  • Independent project, not affiliated with USACE HEC.

Install

python -m pip install --upgrade ras-commander-mcp

Source: github.com/gpt-cmdr/ras-commander-mcp#install-and-configure

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.