EPANET MCP Server

Сервер MCP, который предоставляет гидравлический/водокачественный движок EPANET AI-ассистентам (Claude Desktop, Cursor, VS Code Copilot, Claude Code, …) через stdio — без облачных запросов и браузера.

Он позволяет AI-ассистенту загружать модель EPANET .inp/.net, просматривать её, запускать симуляции, читать результаты по узлам/связям и вносить проверенные изменения — всё локально.

Инструменты

• Сетевой ввод/вывод — load_network, save_network, list_networks

• Инспекция — get_network_summary, get_nodes, get_links, get_coordinates

• Симуляция — run_simulation, get_node_results, get_link_results

• Мутация (проверяется движком, аннулирует результаты) — set_pipe_diameter, set_junction_demand, set_pump_speed, set_valve_setting, set_node_elevation, set_demand_pattern, add_tank, remove_tank, add_valve

• Построение модели — create_network, assign_demands, sample_elevations, fetch_road_network, generate_network_from_bbox

• Помощники проектирования — lookup_pipe_diameters, recommend_diameter, friction_loss, calculate_minor_loss, pipe_sizing_wizard, pump_selection, list_fitting_kfactors

• Оптимизация — optimize_network, run_candidate

generate_network_from_bbox автоматически создаёт скелет узлов/труб на основе реальных дорожных данных OpenStreetMap для ограничивающего прямоугольника, с резервуаром, размещённым у ближайшего водотока, и высотами местности, взятыми из встроенного IFSAR 10 м DEM.

Related MCP server: idfkit-mcp

Предварительные требования

Установка

npm install

Локальный запуск

Каталог данных, из которого сервер читает (load_network) и в который записывает (save_network), ограничен по путям — сервер отказывается от любых файлов вне его.

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

Сервер запускается и ожидает клиента на stdio.

Подключение к AI-приложению

Claude Desktop

Отредактируйте claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в 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

Та же схема работает в Cursor (%APPDATA%\Cursor\User\globalStorage\mcp.json) или VS Code (%APPDATA%\Code\User\mcp.json) — command: "npm", те же args/env.

Конфигурация

Сервер считывает следующие переменные окружения:

Аутентификация по умолчанию выключена; задайте переменные EPANET_AUTH_*, чтобы ограничить доступ к серверу с помощью RS256 bearer-токена.

Тесты

npm test

Модульные тесты используют внутрипроцессный MCP-транспорт с зафиксированными .inp-фикстурами — им не нужен запущенный сервер.

Сборка установочного пакета

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

Создаёт автономный установщик (встроенный Node runtime, системный Node не требуется) в каталоге dist/.

Лицензия

MIT — см. LICENSE.