EPANET MCP Server

一个 MCP 服务器，通过 stdio 将 EPANET 水力/水质引擎置于 AI 助手（Claude Desktop、Cursor、VS Code Copilot、Claude Code 等）之前——无需云端往返，无需浏览器。

它允许 AI 助手加载 EPANET .inp/.net 模型、检查模型、运行模拟、读取每个节点/每个链接的结果，并进行经过验证的编辑，全部在本地完成。

工具

• 网络 I/O — 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（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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

在 dist/ 下生成自包含安装程序（内置 Node 运行时，无需系统 Node）。

许可证

MIT — 参见 LICENSE。