# EPANET MCP Server

MCP-сервер EPANET MCP Server для моделирования водораспределительных сетей через ePyT. Загружает модели, гоняет гидравлические симуляции и строит what-if сценарии по запросу на естественном языке.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 у репозитория
- Автор: Applied-Artificial-Intelligence-Eurecat
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Applied-Artificial-Intelligence-Eurecat/epanet-mcp-server
- Обновлён: 2026-06-02
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/epanet-mcp-server

## Что делает

Сервер оборачивает ePyT — Python-обёртку над EPANET — в инструменты Model Context Protocol. Любая LLM с поддержкой MCP может загрузить модель сети, запустить гидравлическую или качественную симуляцию, поменять параметры и пересчитать результат. Внутри — FastMCP-сервер с потокобезопасным реестром сессий и набором инструментов, разбитых по файлам: загрузка и инспекция, симуляции, изменение параметров, генераторы сценариев.

Сценарии — это клонирование загруженной сети в отдельную сессию, изменение параметров и прогон. Базовую сеть при этом никто не трогает. Доступны готовые генераторы: утечки, аварии на трубах, заражение воды, отказы насосов, одновременный выход из строя нескольких элементов. Для каждой загруженной сети ведётся именованная сессия, так что несколько моделей можно держать открытыми одновременно.

Для работы нужен Python ≥ 3.10, ePyT ≥ 2.0 и пакет mcp ≥ 1.0. Ставятся они через `pip install epyt mcp`, сам сервер — клонированием репозитория и `pip install -e .` или сразу через `uvx epanet-mcp-server`. Запуск в stdio-режиме — командой `epanet-mcp-server`, для HTTP есть флаг `--transport sse --port 8000`. Без ePyT в окружении сервер не стартует, это жёсткая зависимость.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add epanet-mcp-server -- uvx epanet-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from epanet-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add epanet-mcp-server -- uvx epanet-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from epanet-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "epanet-mcp-server": {
            "command": "uvx",
            "args": [
                "epanet-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from epanet-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "epanet-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "epanet-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from epanet-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add epanet-mcp-server uvx epanet-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from epanet-mcp-server <команда>

## Когда брать
- загрузить модель водосети и посмотреть её структуру
- запустить гидравлическую симуляцию без ручного написания кода
- проверить давление и расход в конкретный момент времени
- смоделировать утечку или прорыв трубы
- сравнить сценарии «что если» с базовой сетью, не меняя оригинал

## Примеры запросов агенту
- Загрузи Net1.inp и покажи сводку по сети.
- Прогони полную симуляцию и найди узел с самым низким давлением на 12-м часу.
- Удвой базовый спрос в узле 11 и пересчитай давление после этого.

## Похожие
- [QueueSim](https://affpapa.org/nevibecode/mcp/queuesim.md) — MCP-сервер · 782 установки
- [ITASCA MCP Server](https://affpapa.org/nevibecode/mcp/itasca-mcp-server.md) — MCP-сервер · ★ 234 у репозитория
- [Multisim MCP](https://affpapa.org/nevibecode/mcp/multisim-mcp.md) — MCP-сервер · ★ 48 у репозитория
- [blender-optics-simulator](https://affpapa.org/nevibecode/mcp/blender-optics-simulator.md) — MCP-сервер · ★ 38 у репозитория
- [NetLogo MCP](https://affpapa.org/nevibecode/mcp/netlogo-mcp.md) — MCP-сервер · ★ 28 у репозитория
- [Shaderous](https://affpapa.org/nevibecode/mcp/shaderous.md) — MCP-сервер · ★ 15 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
