AI导哈

EPANET水力网络模拟服务器

为EPANET水力网络提供模拟、分析和可视化的模型上下文协议服务器，支持通过大语言模型加载和修改网络模型。

  • by KWR-Water
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 KWR-Water/epanet-mcp-server

使用说明

KWR的EPANET MCP服务器

概述

用于EPANET配水网络仿真和分析的模型上下文协议服务器。该服务器提供通过大型语言模型加载、模拟、可视化和修改液压网络模型的工具。

请注意，mcp服务器epanet目前处于早期开发阶段。随着我们不断开发和改进服务器，功能和可用工具可能会发生变化和扩展。

出版物

这项工作在 第16届国际水文信息学会议（HIC 2026），西班牙萨拉戈萨，2026年6月22日至26日。

如果您在研究中使用此软件，请引用会议论文：

@inproceedings{zanutto2026epanetmcp,
  title     = {Conversational Hydraulic Modelling: An Open-source Model Context Protocol Server for {EPANET}},
  author    = {Zanutto, Dennis and Michalopoulos, Christos and Savi\'{c}, Dragan},
  booktitle = {TOADD},
  year      = {2026},
  address   = {Zaragoza, Spain},
  doi = {TOADD},
}

如果您特别引用代码或软件包，请同时引用Zenodo版本：

@software{zanutto2026epanetmcp_software,
  title   = {The {EPANET} {MCP} server},
  author  = {Zanutto, Dennis and Michalopoulos, Christos},
  year    = {2025},
  doi     = {10.5281/zenodo.17771952},
  version = {Concept (all versions)},
}

工具

待办事项

安装

使用紫外线（推荐）

使用时 uv 不需要特定的安装。我们将 使用 uvx 直接运行 mcp服务器epanet.

使用PIP

或者，您可以安装 mcp-server-epanet 通过pip：

pip install mcp-server-epanet

安装后，您可以使用以下命令将其作为脚本运行：

python -m mcp_server_epanet

配置

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

Using uvx 
"mcpServers": {
  "epanet": {
    "command": "uvx",
    "args": ["mcp-server-epanet"]
  }
}
Using pip installation 
"mcpServers": {
  "epanet": {
    "command": "python",
    "args": ["-m", "mcp_server_epanet"]
  }
}

使用VS代码

对于手动安装，请将配置添加到名为 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "epanet": {
      "command": "uvx",
      "args": ["mcp-server-epanet"]
    }
  }
}

或者使用本地紫外线装置：

{
  "servers": {
    "epanet": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "mcp-server-epanet"]
    }
  }
}

有关VS Code中MCP配置的更多详细信息，请参阅 官方VS Code MCP文档.

调试

您可以使用MCP检查器调试服务器。对于uvx安装：

npx @modelcontextprotocol/inspector uvx mcp-server-epanet

或者，如果您正在本地开发：

cd path/to/epanet-mcp-server
npx @modelcontextprotocol/inspector uv run mcp-server-epanet

跑步 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 将显示服务器的日志，并可能 帮助您调试任何问题。

发展

如果您正在进行本地开发，有两种方法可以测试您的更改：

  1. 运行MCP检查器以测试您的更改。看 调试 用于运行说明。

  2. 使用Claude桌面应用程序进行测试。将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "epanet": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/epanet-mcp-server",
        "run",
        "mcp-server-epanet"
      ]
    }
  }
}

相关 MCP