Agentic-MIKE-Plus 是一个面向 MIKE+ 城市水建模的无头、自然语言驱动的自动化建模工作流。它由 Skills（Markdown 操作手册）和一个 MCP 服务器组成，可配合 Claude Code、Codex、Hermes 或 OpenClaw 等 AI 编码代理使用：用自然语言描述目标，代理即可对 MIKE+ 模型执行检查、编辑、运行、读取和绘图，端到端完成建模与分析，全程无需打开 GUI。
用途与定位 该项目面向需要批量与场景自动化的 MIKE+ 建模任务，可在工作站、服务器、CI 环境或代理下运行。它被标注为实验性/预发布版本，已在 MIKE+ 2026 的 Sirius_RTC 示例上完成端到端验证，是 agentic-swmm-workflow 的姊妹项目。
主要能力
- 自然语言驱动：用平实语言描述任务，代理自行规划并执行，无需编写脚本或点击 GUI。
- 完全无头：不依赖 GUI，适合批处理与场景自动化。
- MCP 原生且可移植：一个服务器实现 Model Context Protocol，通过一行配置即可与 Claude Code、Codex、Hermes 或 OpenClaw 配合，并通过 pip 安装。
- 低共享门槛：读取结果与绘图不需要 MIKE+ 许可证，只有运行或编辑才需要；团队成员仅用 pip install . 即可分析模型输出。
- 可复现且经过测试：确定性工具、结构化 JSON 输出、固定版本的 lockfile，以及 CI 中免许可证的单元测试套件，并在真实模型上验证。
- 引擎无关且可扩展：结果使用通用 schema（可与 SWMM 和 LSTM 并列）；通过放入一个文件即可添加工具或技能。
架构与工具 Skills（Markdown 操作手册）告诉代理何时以及如何操作；代理调用 MCP 工具；每个工具在隔离的 worker 子进程中运行，该子进程只导入 mikeplus 或 mikeio*（两者不能共享同一进程）。服务器本身不导入这两者。
服务器名为 mike-plus，由十个技能进行编排：mike-end-to-end（SOP：模式、运行目录、停止规则、QA 门禁）、mike-model、mike-params、mike-runner、mike-import、mike-results、mike-compare、mike-plot、mike-rain、mike-audit。
安装与使用方式 项目要求 Python 3.11（x64），提供两种安装配置：
- 读取与绘图：免许可证、跨平台，执行 pip install -e .（不安装 mikeplus）。
- 运行与编辑：需要 Windows 与已授权的 MIKE+ 2026，执行 pip install -e ".[run]"（或 pip install -r requirements.lock 以获得精确固定的环境）。 其中 mikeplus 是可选 [run] 附加项，因此只读取结果或制作图表的团队成员无需安装任何与许可证绑定的内容。
技能可通过一条命令安装到任何支持 skills 的代理（Claude Code、Codex、OpenCode 等），无需克隆仓库。
适用场景
- 需要批量运行与场景自动化的 MIKE+ 建模工作。
- 在 CI 或服务器环境中进行无 GUI 的模型检查、参数编辑、模拟运行与结果分析。
- 团队协作中，部分成员仅需读取结果与绘图，无需 MIKE+ 许可证。
- 需要将 MIKE+ 结果与 SWMM、LSTM 等其他引擎结果并列比较的场景。
限制与说明
- 项目为实验性/预发布状态。
- 运行或编辑模型需要有效的 DHI 许可证与 Windows 环境及 MIKE+ 2026；读取结果与绘图则免许可证且跨平台。
- 项目基于 DHI 的 mikeplus / mikeio / mikeio1d 与 Model Context Protocol 构建；MIKE+ 是 DHI 的产品。
- 采用 MIT 许可（© 2026 Zhonghao Zhang, University of Victoria）。
- 关于完整证据（命令、输出与许可证边界）可参见 docs/verification.md。
- 若需要一个可运行的模型，SWMMCanada 可在加拿大任意地点构建：在地图上绘制区域，即可从加拿大开放数据组装出可运行的雨水模型（8 个城市使用真实市政雨水管网，其他地区为合成数据），为代理提供可运行、编辑、读取和绘图的真实管网；可访问 swmm.h2ox.me 试用托管演示（无需安装），或访问 h2ox.me 查看项目。
