openfoam-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OpenFOAM MCP — a CFD co-pilot for any MCP client
openfoam-mcp is a Model Context Protocol
server that turns an AI assistant (Claude Desktop, and any other MCP client)
into an OpenFOAM setup and debugging co-pilot. It scaffolds runnable cases,
edits dictionaries safely, sizes your near-wall mesh, computes inlet turbulence
values, and reads solver logs to tell you whether a run converged or blew up —
all without you leaving the chat.
Most of the tools are pure Python and need no OpenFOAM installation, so they
work anywhere. The few that call OpenFOAM utilities (e.g. blockMesh,
checkMesh) detect the environment and degrade gracefully when it is absent.
Why it's useful
Setting up a CFD case is fiddly bookkeeping: the right y+, matching boundary
patches between the mesh and every 0/ field, consistent turbulence fields for
the chosen model, a stable Courant number, and reading pages of residual output
to see if it converged. This server does that bookkeeping through natural
language.
Tools
Tool | What it does |
| List scaffold-able solver templates (simpleFoam, pimpleFoam, icoFoam). |
| Reynolds number, laminar/turbulent verdict, turbulence-model recommendation. |
| First-cell height for a target |
| Inverse: predicted |
| Inlet |
| Transient time step from a target Courant number. |
| Write a runnable case tree ( |
| Read a dictionary file or a single entry (via |
| Set a dictionary keyword (nested via |
| Set/insert a patch's |
| Validate a case: files present, turbulence fields consistent, patches match mesh. |
| Parse a solver log → per-field residual drop + convergence verdict. |
| Run a whitelisted OpenFOAM utility inside a case (if installed). |
Install & run
The server ships as a PyPI package with a console entry point, so the usual
zero-install runner is uvx:
uvx openfoam-mcpor install it into an environment:
pip install openfoam-mcp
openfoam-mcpClaude Desktop configuration
Add this to claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/,
Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"openfoam": {
"command": "uvx",
"args": ["openfoam-mcp"]
}
}
}Restart Claude Desktop; the OpenFOAM tools appear under the tools menu.
Example prompts
"I have air at 30 m/s over a 0.5 m chord. What Reynolds number is that, and what first-cell height do I need for y+ = 1?"
"Scaffold a steady simpleFoam case in ./duct at 12 m/s and check it."
"Set
endTimeto 3000 in ./duct/system/controlDict.""Read ./duct/log.simpleFoam and tell me if it converged."
Solver templates
Template | Physics | Typical use |
| Steady incompressible RANS (k-ω SST) | Ducts, external aero, general steady flow |
| Transient incompressible RANS (k-ω SST) | Vortex shedding, unsteady flows |
| Transient incompressible laminar | Low-Re teaching cases (cavity, low-Re pipe) |
Templates follow the OpenFOAM foundation v9–v12 / ESI v2306+ tutorial style
(transportProperties + momentumTransport). The generated box mesh has
patches inlet, outlet, walls, frontAndBack.
Development
pip install -e ".[dev]"
pytestLicense
MIT © 2026 Tanawat Manokieng
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Run FDS, OpenFOAM, CalculiX and other engineering simulations on cloudHPC from your AI assistant.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Deploy, monitor, and manage your OpenClaw AI assistants via natural language.
Build, validate, test-run and publish AIOS workflows from Claude Code, Codex, Cursor or VS Code.
1