HMS Commander MCP

MCP serverCommunity

A read-only MCP server that reads HEC-HMS project, basin, gage and run text through hms-commander. By CLB Engineering (gpt-cmdr).

0 starsUpdated 3 weeks agoGitHub data from 5 Nov 2026

At a glance

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

Reads project and component text, scalar parameters, gage configuration and control and run relationships.
Only reads inside project roots you pass with --root.
Needs no Java, HEC-HMS executable, GIS or DSS libraries.
Returns compact answers with source identity, versions, units and truncation notes.

Doesn't compute models, modify projects or read DSS, HDF, SQLite, geometry or spatial results.
The author recommends exposing its tools only to an isolated subagent.
Independent project, not associated with HEC.

python -m pip install --upgrade hms-commander-mcp
hms-commander-mcp --root /absolute/path/to/project

{
  "mcpServers": {
    "hms-commander": {
      "command": "hms-commander-mcp",
      "args": ["--root", "/absolute/path/to/project"]
    }
  }
}

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.