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

Install & run

The server ships as a PyPI package with a console entry point, so the usual zero-install runner is uvx:

uvx openfoam-mcp

or install it into an environment:

pip install openfoam-mcp
openfoam-mcp

Claude 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 endTime to 3000 in ./duct/system/controlDict."

• "Read ./duct/log.simpleFoam and tell me if it converged."

Solver templates

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]"
pytest

License

MIT © 2026 Tanawat Manokieng