Servidor MCP de EPANET

Un servidor MCP que pone el motor hidráulico/de calidad del agua EPANET al alcance de asistentes de IA (Claude Desktop, Cursor, VS Code Copilot, Claude Code, …) a través de stdio — sin ida y vuelta a la nube, sin navegador.

Permite que un asistente de IA cargue un modelo .inp/.net de EPANET, lo inspeccione, ejecute simulaciones, lea resultados por nodo/enlace y realice ediciones validadas, todo localmente.

Herramientas

• E/S de red — load_network, save_network, list_networks

• Inspección — get_network_summary, get_nodes, get_links, get_coordinates

• Simulación — run_simulation, get_node_results, get_link_results

• Mutación (validada por el motor, invalida resultados) — set_pipe_diameter, set_junction_demand, set_pump_speed, set_valve_setting, set_node_elevation, set_demand_pattern, add_tank, remove_tank, add_valve

• Construcción de modelos — create_network, assign_demands, sample_elevations, fetch_road_network, generate_network_from_bbox

• Ayudas de diseño — lookup_pipe_diameters, recommend_diameter, friction_loss, calculate_minor_loss, pipe_sizing_wizard, pump_selection, list_fitting_kfactors

• Optimización — optimize_network, run_candidate

generate_network_from_bbox diseña automáticamente un esqueleto de nudos/tuberías a partir de datos reales de carreteras de OpenStreetMap para un cuadro delimitador, con un depósito colocado en la vía fluvial más cercana y elevaciones del terreno muestreadas de un DEM IFSAR de 10 m incluido.

Related MCP server: idfkit-mcp

Requisitos previos

Instalación

npm install

Ejecución local

El directorio de datos desde el que el servidor lee (load_network) y al que escribe (save_network) está contenido en una ruta — el servidor rechaza cualquier archivo fuera de él.

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

El servidor arranca y espera a un cliente en stdio.

Conéctalo a una aplicación de IA

Claude Desktop

Edita claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json en Windows, ~/Library/Application Support/Claude/claude_desktop_config.json en 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

La misma estructura funciona en Cursor (%APPDATA%\Cursor\User\globalStorage\mcp.json) o VS Code (%APPDATA%\Code\User\mcp.json) — command: "npm", mismos args/env.

Configuración

El servidor lee estas variables de entorno:

La autenticación está desactivada por defecto; establece las variables EPANET_AUTH_* para proteger el servidor con un token de portador RS256.

Pruebas

npm test

Las pruebas unitarias utilizan el transporte MCP en memoria con archivos .inp de ejemplo incluidos — no requieren un servidor en ejecución.

Crear un instalador empaquetado

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

Produce un instalador autocontenido (runtime de Node incluido, sin necesidad de Node del sistema) en dist/.

Licencia

MIT — consulta LICENSE.