Comsol Mph Analyzer

COMSOL Toolkit

4-module toolkit for COMSOL Multiphysics workflows. Python stdlib only (no external packages required).

Module 1: Value Extraction

Extract parameters, physics, materials, species, geometry, and metadata from .mph files.

python scripts/analyze_mph.py model.mph                  # Full report
python scripts/analyze_mph.py model.mph --parameters     # Parameters table
python scripts/analyze_mph.py model.mph --physics        # Physics interfaces
python scripts/analyze_mph.py model.mph --json           # All data as JSON
python scripts/analyze_mph.py model.mph --tree           # Model tree
python scripts/analyze_mph.py model.mph --export-xml DIR # Extract XML/JSON files

See references/mph_format.md for .mph file format details.

Module 2: Input Preparation

Prepare simulation inputs: parameter files, .mph XML modification, Java API code generation.

# Parameter file generation
python scripts/prepare_inputs.py model.mph --extract                          # Extract as JSON
python scripts/prepare_inputs.py model.mph --paramfile out.txt                # comsolbatch format
python scripts/prepare_inputs.py model.mph --paramfile out.txt --set "T_in=950[K]"  # Override
python scripts/prepare_inputs.py model.mph --sweep "T_in=800[K]:50[K]:1000[K]" --paramfile-dir ./sweep/

# Direct .mph XML modification (no COMSOL needed)
python scripts/modify_mph_xml.py input.mph output.mph --set "T_in=950[K]"
python scripts/modify_mph_xml.py input.mph output.mph --from-json overrides.json
python scripts/modify_mph_xml.py input.mph --diff   # Dry run

# Java API code generation
python scripts/generate_java.py model.mph                        # Print to stdout
python scripts/generate_java.py model.mph --output Model.java    # Write to file
python scripts/generate_java.py model.mph --class-name SteamReformer

See references/input_preparation.md for comsolbatch CLI and workflow details.

Module 3: MCP Connectivity

Check COMSOL environment and set up MCP server for Claude-controlled simulation.

python scripts/check_comsol.py          # Diagnostic report
python scripts/check_comsol.py --json   # JSON output

See references/mcp_setup.md for server setup and references/mcp_tools.md for tool reference.

Module 4: 3D Morphology Edit

Edit mphtxt mesh and STL geometry files programmatically.

# mphtxt mesh editing
python scripts/edit_mphtxt_mesh.py mesh.mphtxt --info
python scripts/edit_mphtxt_mesh.py mesh.mphtxt --translate 0.1 0 0 -o out.mphtxt
python scripts/edit_mphtxt_mesh.py mesh.mphtxt --scale 2.0 -o out.mphtxt
python scripts/edit_mphtxt_mesh.py mesh.mphtxt --rotate 90 0 0 1 -o out.mphtxt
python scripts/edit_mphtxt_mesh.py mesh.mphtxt --mirror 1 0 0 -o out.mphtxt

# STL editing
python scripts/edit_stl.py model.stl --info
python scripts/edit_stl.py model.stl --translate 0.1 0 0 --scale 2 -o out.stl
python scripts/edit_stl.py model.stl --rotate 90 0 0 1 -o out.stl
python scripts/edit_stl.py model.stl --to-mphtxt out.mphtxt  # Convert STL -> COMSOL mesh

See references/geometry_formats.md for format specifications.

Capabilities Matrix

Limitations

• Cannot read binary .mphbin data (geometry coordinates inside .mph, mesh solutions)
• Cannot run simulations without COMSOL installation
• Cannot edit Parasolid geometry (.mphtxt geometry format is binary-encoded)
• Cannot edit STEP files without cadquery/OCP
• Password-protected .mph files cannot be analyzed