dsh-comsol

DSH plugin: drive COMSOL Multiphysics models end to end from any chat - open a model in the visible desktop, read/modify parameters, rebuild the mesh, tune the solver, run steady or time-dependent studies with live progress, load results into the desktop plot, evaluate numbers and export images.

Toggling the plugin in the DSH plugin panel enables/disables the comsol-dsh skill for every workspace; the skill is the single entry point and the plugin carries everything it needs.

Install (any DSH user)

In the DSH plugin panel, install from:

github:Twofruitsgrape/dsh-comsol

(or the repository URL). DSH fetches the bundle with pnpm, mounts it through cordis.patch.yml, and the skill appears in new sessions. Restart DSH after installing.

Requirements on the machine:

• COMSOL Multiphysics 6.0 - 6.3 with a valid license (fully verified on 6.2)
• Python 3.10+ with the mcp package: pip install mcp (plus MPh>=1.4 and tomlkit if you prefer pip install -e assets/engine)
• Windows desktop session (the COMSOL window is shown live; headless works too)

What ships inside

index.js                 skill provider; name/description parsed from the
                         SKILL.md frontmatter (single source of truth)
cordis.patch.yml         plugin mount + the panel toggle target
assets/comsol-dsh/       the skill: SKILL.md playbook, run_workflow.py (steady),
                         run_transient.py (time-varying BC -> transient solve),
                         offline tests
assets/engine/           the comsol-mcp MCP server (Python), vendored: no
                         external checkout or pip install needed

index.js imports only node: builtins and declares no dependencies, so DSH upgrades can never break plugin loading through version resolution.

Quick start

# offline preflight (starts nothing)
python assets/comsol-dsh/scripts/run_workflow.py --model "<abs>.mph" --home "<dir>" --check
# steady workflow: params -> mesh -> solve -> plot -> save
python assets/comsol-dsh/scripts/run_workflow.py --model "<abs>.mph" --home "<dir>" --set-param I=200[A] --save-as "<out>.mph"
# transient workflow: time-varying BC -> Time Dependent study -> solve -> results on screen
python assets/comsol-dsh/scripts/run_transient.py --model "<abs>.mph" --home "<dir>" --save-as "<out>.mph" --allow-code

Full playbook, hard rules and field-tested COMSOL 6.2 traps: assets/comsol-dsh/SKILL.md.

Verified

COMSOL 6.2 + MPh 1.4 + Python 3.12 on the busbar electro-thermal case: steady solve T 337.7-349.8 K; transient ramp Tbc(t)=293.15+60(1-e^(-t/15)) on the convective ambient, 61 time steps, maxT 293.15 -> 307.90 K; zero leftover locks/processes; 35 skill + 58 engine offline tests green.

License

MIT - see LICENSE. COMSOL is a trademark of COMSOL AB; this project is not affiliated with or endorsed by COMSOL AB.