Agentic MIKE Plus

What Zhonghao1995/Agentic-MIKE-Plus MCP server does

Zhonghao1995/Agentic-MIKE-Plus MCP server connects an MCP-compatible agent to headless DHI MIKE+ modelling workflows. The repository includes both an MCP server and skills that guide an agent through model inspection, parameter changes, simulation execution, result analysis, plotting, and audit-oriented workflow steps.

The workflow is intended for urban-water models. Available operations include reading model metadata, selecting an existing scenario, getting and setting model values, running simulations, and importing EPA SWMM or EPANET input files into a new MIKE+ model. Result-oriented functions can inspect .res1d contents, identify flooding, compare baseline and scenario outputs, create hydrographs and other time-series figures, draw network maps or profiles, convert rainfall CSV data into MIKE+ .dfs0 files, and write provenance manifests.

How it works

An agent reads the repository's markdown skills and calls MCP tools based on the requested modelling task. Each tool delegates MIKE+ work to an isolated subprocess. Packages associated with model editing and packages associated with result reading are kept in separate workers because mikeplus and the mikeio family cannot share one process. The server itself does not import those engine packages directly.

The workflow is designed for headless execution on a workstation, server, CI environment, or agent runtime. Tool responses use structured JSON, and simulation execution returns the generated .res1d path together with parsed quality-assurance status such as completion, errors, or warnings.

Setup and configuration

Zhonghao1995/Agentic-MIKE-Plus MCP server requires Python 3.11 x64; the README states that the MIKE+ package supports Python 3.9 through 3.11 and not Python 3.12 or newer. Install the repository into a virtual environment with pip install -e . for the read-and-plot profile. This profile does not install the optional mikeplus dependency and is intended for license-free result analysis and figures.

For model execution, editing, scenario operations, or SWMM/EPANET import, install the [run] extra, or use the pinned requirements lock file. Those operations require Windows and a valid MIKE+ 2026 license. The repository includes an MCP configuration sample and a server module named mikeplus_mcp.server. Skills can be copied into a skills-aware agent's skills directory.

Tools and capabilities

The documented tool groups cover:

• Model inspection, scenario activation, parameter reads, and parameter edits.
• Headless simulation runs with parsed engine-log QA results.
• SWMM or EPANET input import into a new MIKE+ model.
• .res1d listing, time-series reads, flooding analysis, and run comparisons.
• Rainfall-to-.dfs0 conversion and plots for rainfall, flow, time series, networks, comparisons, and profiles.
• Provenance manifests containing model, input, edit, run, result, and figure references with SHA-256 values.

Limitations and notes

Zhonghao1995/Agentic-MIKE-Plus MCP server is marked experimental or pre-release. The repository reports end-to-end verification with the MIKE+ 2026 Sirius_RTC example, but that does not establish compatibility with every MIKE+ model or installation. Read and plot functionality is described as license-free, while running, editing, and importing depend on the Windows MIKE+ 2026 license boundary. MIKE+ remains a DHI product and is not included under this repository's MIT license.

The README names Claude Code, Codex, Hermes, OpenClaw, and other skills-aware agents as usage targets. It does not document Claude Desktop, Cursor, Windsurf, or Cline configuration. The repository's own code is MIT licensed; external DHI components retain their separate licensing requirements.