EPANET MCP Server

Ein MCP Server, der die EPANET Hydraulik-/Wasserqualitäts-Engine vor KI-Assistenten (Claude Desktop, Cursor, VS Code Copilot, Claude Code, …) über stdio platziert — kein Cloud-Roundtrip, kein Browser.

Es ermöglicht einem KI-Assistenten, ein EPANET-.inp/.net-Modell zu laden, es zu inspizieren, Simulationen auszuführen, Ergebnisse pro Knoten/pro Verbindung zu lesen und validierte Änderungen vorzunehmen – alles lokal.

Werkzeuge

• Netzwerk-I/O — load_network, save_network, list_networks

• Inspektion — get_network_summary, get_nodes, get_links, get_coordinates

• Simulation — run_simulation, get_node_results, get_link_results

• Mutation (engine-validiert, Ergebnisse invalidierend) — set_pipe_diameter, set_junction_demand, set_pump_speed, set_valve_setting, set_node_elevation, set_demand_pattern, add_tank, remove_tank, add_valve

• Modellaufbau — create_network, assign_demands, sample_elevations, fetch_road_network, generate_network_from_bbox

• Entwurfshilfen — lookup_pipe_diameters, recommend_diameter, friction_loss, calculate_minor_loss, pipe_sizing_wizard, pump_selection, list_fitting_kfactors

• Optimierung — optimize_network, run_candidate

generate_network_from_bbox legt automatisch ein Knoten-/Rohrskelett aus echten OpenStreetMap-Straßendaten für eine Begrenzungsbox an, mit einem Reservoir am nächsten Wasserweg und Geländehöhen, die aus einem gebündelten IFSAR-10-m-DEM abgetastet werden.

Related MCP server: idfkit-mcp

Voraussetzungen

Installation

npm install

Lokal ausführen

Das Datenverzeichnis, aus dem der Server liest (load_network) und in das er schreibt (save_network), ist pfadgebunden – der Server verweigert jede Datei außerhalb davon.

mkdir -p data
cp your-model.inp data/
export EPANET_DATA_DIR=$(pwd)/data
npm start

Der Server startet und wartet auf einen Client auf stdio.

An eine KI-App anbinden

Claude Desktop

Bearbeiten Sie claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json unter Windows, ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "epanet": {
      "command": "npm",
      "args": ["start"],
      "cwd": "<absolute path to this repo>",
      "env": {
        "EPANET_DATA_DIR": "<absolute path to this repo>/data"
      }
    }
  }
}

Cursor / VS Code

Dasselbe Muster funktioniert in Cursor (%APPDATA%\Cursor\User\globalStorage\mcp.json) oder VS Code (%APPDATA%\Code\User\mcp.json) – command: "npm", gleiche args/env.

Konfiguration

Der Server liest diese Umgebungsvariablen:

Die Authentifizierung ist standardmäßig deaktiviert; setzen Sie die EPANET_AUTH_*-Variablen, um den Server hinter einem RS256-Bearer-Token zu schützen.

Tests

npm test

Unit-Tests treiben den In-Memory-MCP-Transport gegen eingecheckte .inp-Fixtures – sie erfordern keinen laufenden Server.

Paketinstaller erstellen

npm run package:win    # or package:mac / package:linux

Erzeugt ein eigenständiges Installationsprogramm (mit gebündelter Node-Laufzeit, kein System-Node erforderlich) unter dist/.

Lizenz

MIT – siehe LICENSE.