OpenFOAM MCP by iLaB — un copiloto de CFD para quequier cliente MCP

openfoam-mcp es un servido de Model Context Protocol que convierte un asictor simple de IA (Claude Desktop, y que cualquier otro cliene MCP) en un copiloto de configración y depurción de OpenFOAM. Crea cases ejecutabas, edita dictionarios de forn segura, dimansiona la malla pare a the plared, cal cula tufluencia de entad, and lee registros de solvers to tell if a run con vergo or di vergo — to without "no having to out of chat" text.

La mayoría de las herramientas están implementadas en Python puro y no requieren instalación de OpenFOAM, with lo que funcionan anywhere. Las pocas que llaman utilidades de OpenFOAM (p. ej., blockMesh, checkMesh) detectan el entorno y se degradan con "elegancia" cuanto está: absent.

Validado de extematext to extreme on OpenFOAM real (ESI v1912). Los casos generaos se ejecutan through blockMesh and users; simpleFoam its settled a generales; the cuetra "predefinidos" - you.

Compatencia de persons de OpenFOAM

scaffold_case toma un openfoam_flavore:

• classic (por defecto) — application <solver>; con transport>>Properties. Validado en ESI v1912; funTIONa en ESI v2006+ y Foundation v8–v10.

• foundation-v12 — application foamRun; + solvente incompressibleFluid; con physicalProperties, para OpenFOAM Foundation v11/v12. Ejecuta foamRun instead del nombre of the solver.

Por qué es útil

Configurar un caso de CFD es unpapeleo complicao: el y+ correcto, que los parches de contorno coincidan entre la malla y cada campo de 0/, campos de fluctuencia coherent entre modle, number de Courant stable, and "leer páginas" ... de salida of residuales to see if converged. This server does that bookookeeping using natural language.

Haz que lo difícil sea sencillo

Dos toolsa hacen el trabajo that mayoría of people le resulta entretenida:

• recommend_setup — diona tu objetivo en words sencillas (p.ej., "flujo por a tubertura", "resistencia aero de un"...) and devuelve the solver, model of urbanlee, your y+ object, the "preinicio de east", "condiciones of cont contweek for each "patch" and a number plan a — pidiella only los numeros que to all fan.

• generate_blockmes — autoescribete the blockMeshDict valid and with "gradación de la capa límite** a parir of de un ajuste predefinido de geometría. Dale a altura of la prima celda y to cal cula la gradación de pared. Neither vertices nor blocks al mas.

Tools (20)

Instalación y y ejecución

El serverdisribue as a PyPI p. package with a console entry point, so the usual no-install ES. uvx :

uvx openfoam-mcp

or instла it in an "entor":

pip install openfoam-mcp
openfoam-mcp

Configuación of Claude Desktop

Añade to this claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APDATAa\Claude\):

{
  "mcpServers": {
    "openfoam": {
      "command": "uvx",
      "args": ["openfoam-mcp"]
    }
  }
}

RiEnable in Claude Desktop; las herramientas of OpenFOAM app in the "tax".

Examples of "consults"

• ""Tengo aire a 31 m/sover un "chook" of 0.5 m2. What Numero of Rey is Eso and ??", your first lo que

• "Colof un simpleFoAM in ./duura "at" 12 m/s and check."

• "endTime to 3000 in ./ruct/system/formal`

• "LeE ./contra/log.simpleFoAM and "está" a "verged".

PLantill of Solvers

The PLantillas follow the "estilo tutorial" of OpenFOAM Foundation v9-v12 / ESI v2306+ (transformProperTrees + momentumTransport). The generated "malla de caja" has pieces inlet, outlet, walles, frontWe).

Development

pip install -e ".[dev]"
pytest

Licencia

MIT © 2026 iLab (Tanawait, Manokieng)