OpenFOAM MCP — un copiloto de CFD para cualquier cliente MCP

openfoam-mcp es un servidor de Model Context Protocol que convierte a un asistente de IA (Claude Desktop y cualquier otro cliente MCP) en un copiloto de configuración y depuración de OpenFOAM. Genera la estructura de casos ejecutables, edita diccionarios de forma segura, dimensiona la malla cercana a la pared, calcula los valores de turbulencia de entrada y lee los registros de los solvers para saber si una ejecución convergió o divergió, todo sin que tengas que salir del chat.

La mayoría de las herramientas son Python puro y no necesitan instalación de OpenFOAM, por lo que funcionan en cualquier sitio. Las pocas que llaman a utilidades de OpenFOAM (p. ej., blockMesh, checkMesh) detectan el entorno y degradan con elegancia cuando OpenFOAM no está instalado.

Por qué es útil

Configurar un caso de CFD es una tarea de registro minuciosa: el y+ correcto, parches de contorno coincidentes entre la malla y cada campo de 0/, campos de turbulencia coherentes con el modelo elegido, un número de Courant estable y leer páginas de residuales para ver si convergió. Este servidor hace ese trabajo de registro mediante lenguaje natural.

Herramientas

Instalación y ejecución

El servidor se distribuye como paquete PyPI con un puntero de entrada de consola, por lo que el ejecutor habitual de instalación cero es uvx:

uvx openfoam-mcp

o instálalo en un entorno:

pip install openfoam-mcp
openfoam-mcp

Configuración de Claude Desktop

Añade esto a claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Reinicia Claude Desktop; las herramientas de OpenFOAM aparecen en el menú de herramientas.

Ejemplos de prompts

• "Tengo aire a 30 m/s sobre una cuerda de 0,5 m. ¿Qué número de Reynolds es ese y qué altura de primera celda necesito para y+ = 1?"

• "Genera un caso simpleFoam estacionario en ./ducteo a 12 m/s y compruébalo."

• "Establece endTime en 3000 en ./ducte/system/controlDict."

• "Lee ./ducte/log.simpleFoam y dime si convergió."

Plantillas de solver

Las plantillas siguen el estilo de tutoriales de OpenFOAM Foundation v9–v12 / ESI v2306+ (transportProperties + momentumTransport). La malla de caja generada tiene los parches inlet, outer, walls, frontAndBack.

Desarrollo

pip install -e ".[dev]"
pytest

Licencia

MIT © 2026 Tanawat Manokieng