Skip to content
Tresca

Gmsh MCP Server

MCP serverCommunity

Builds structured Gmsh meshes from box, O-H cylinder and pipe templates, checks quality, shows checkpoints and exports to OpenFOAM. By OFFTECH.

0 starsUpdated 6 weeks agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
Gmsh, OpenFOAM
How it connects
Reads and writes files; the tool isn't needed
Access
Can modify models
Tool versions
Gmsh 4.15.2 Python wheel by default; a matching Gmsh 5 SDK can be selected
Operating systems
Windows, macOS, Linux
Needs a Gmsh licence
No
Transport
Local (stdio)
AI clients documented
Not stated in its documentation
Licence
GPL-3.0
Language
Python

What it can do

  • Thirty-six tools for sessions, OCC geometry, structured templates, grading, mesh jobs, quality histograms, viewing and export.
  • Runs each model in its own worker process with revision guards, so a crash or restart doesn't leak state between sessions.
  • Shows immutable geometry and mesh checkpoints in a Gmsh GUI window and captures PNGs.
  • Exports MSH 2.2 with checksummed manifests and can convert to OpenFOAM and run checkMesh.

Limitations

  • Favours structured meshes; arbitrary CAD import and automatic block decomposition are not implemented.
  • First-order meshes in metres and MSH 2.2 ASCII export only.
  • OpenFOAM conversion was validated with OpenFOAM 13 under WSL Ubuntu 24.04.

Install

git clone https://github.com/OFFTECH/gmsh-mcp-server.git
cd gmsh-mcp-server
uv sync
uv run gmsh-mcp doctor

Source: github.com/OFFTECH/gmsh-mcp-server#install-and-verify

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.