DualSPHysics MCP Server

Ten Model Context Protocol tools wrap a local DualSPHysics SPH toolchain end to end: design cases as structured parameters (no hand-written XML, no solver needed to iterate), run them as background…

Local serverstdio

What is the DualSPHysics MCP Server?

dualsphysics-mcp is an MCP project maintained in the vegetableno1/dualsphysics-mcp repository. The maintainer describes its purpose as “Ten Model Context Protocol tools wrap a local DualSPHysics SPH toolchain end to end: design cases as structured parameters (no hand-written XML, no solver needed…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is dualsphysics-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
check_environmentFind the four DualSPHysics tools on this machine: resolved path, provenance (env var, PATH, scan), version, solver feature flags; install hints when one is…
create_caseDescribe a 2D dam-break experiment in plain parameters and get a GenCase _Def.xml back — no XML by hand, no solver needed. Returns a particle-count estimate…
edit_caseChange parameters of an existing case (in place or to a save_path), re-validating the merged result.
describe_caseRead a case file back as a summary: dp, domain, column/tank/obstacle, timing, gauges, particle estimate.
gencaseDiscretise the case into Case.xml + Case.bi4 (plus preview VTK) and report the real particle counts.
run_caseStart the CPU solver in the background (jobs/ directory, Run.out, Part_.bi4) and return a job_id immediately.
job_statusPoll a job: state, t/tmax, percent, the solver's Time/Sec throughput and projected finish, Run.out tail.
partvtkTurn Part_.bi4 output into VTK particle files for ParaView; filters and variables pass through.
measure_toolProbe the solution at points and get CSV time series back (comma separator enforced for deterministic parsing).
validate_dambreakReconstruct the dam-tip surge front from the CSV and score it against the embedded Koshizuka & Oka (1996) series: per-time errors + MAE/RMSE/max.

How to install the DualSPHysics MCP Server

{
  "mcpServers": {
    "dualsphysics-mcp": {
      "command": "uvx",
      "args": [
        "dualsphysics-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.