OpenFOAM MCP Server (webworn)
MCP serverCommunity
A C++ MCP server for OpenFOAM 12 aimed at CFD teaching, with guided questioning, mesh checks and pipe-flow tools. By webworn.
127 starsUpdated 10 months agoGitHub data from 5 Nov 2026
At a glance
- Type
- MCP server
- Works with
- OpenFOAM
- How it connects
- Drives a running copy of the tool
- Access
- Can modify models
- Tool versions
- OpenFOAM 12 (openfoam.org); the README marks solver migration for OF12 as still partial
- Operating systems
- Linux
- Needs a OpenFOAM licence
- No
- Transport
- Local (stdio)
- AI clients documented
- Claude Code
- Licence
- Apache-2.0
- Language
- C++
What it can do
- Registers 12 tools, including a guided CFD conversation, a generic tool to run mesh, solve and post-process steps, and result analysis with explanations.
- Assesses mesh quality and checks STL geometry for snappyHexMesh readiness.
- Works out turbulent pipe-flow quantities such as friction factor, pressure drop, y+ and first cell height, and suggests k-epsilon or k-omega SST.
- Includes a set of rotating detonation engine tools for 2D and 3D wave analysis and geometry.
Limitations
- The author rates the system about 75% functional; OpenFOAM integration is marked partial and heat-transfer and multiphase work is still in development.
- Built for Ubuntu 20.04+ or Debian 11+ from source with CMake; no packaged release.
- Much of the tool set is teaching-oriented (Socratic questioning) rather than general case setup.
Install
git clone https://github.com/webworn/openfoam-mcp-server.git
cd openfoam-mcp-server
mkdir build && cd build
cmake ..
make -j$(nproc)Source: github.com/webworn/openfoam-mcp-server#build-mcp-server
claude mcp add-json openfoam-mcp-server '{
"command": "/workspaces/openfoam-mcp-server/build/openfoam-mcp-server-test",
"args": [],
"env": {
"LD_LIBRARY_PATH": "/opt/openfoam12/platforms/linux64GccDPInt32Opt/lib/dummy:/opt/openfoam12/platforms/linux64GccDPInt32Opt/lib",
"FOAM_INST_DIR": "/opt/openfoam12",
"WM_PROJECT_DIR": "/opt/openfoam12",
"FOAM_LIBBIN": "/opt/openfoam12/platforms/linux64GccDPInt32Opt/lib",
"FOAM_APPBIN": "/opt/openfoam12/platforms/linux64GccDPInt32Opt/bin",
"FOAM_ETC": "/opt/openfoam12/etc",
"PATH": "/opt/openfoam12/platforms/linux64GccDPInt32Opt/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
}
}'Source: github.com/webworn/openfoam-mcp-server#-claude-code-integration
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.