OpenFOAM MCP by iLab — 面向任何 MCP 客户端的 CFD 副驾驶

openfoam-mcp is a Model Context Protocol server that turns an AI assistant (Claude Desktop, 或任何其他 MCP 客户端) into an OpenFOAM setup and debugging co-pilot. 它负责搭建可运行的算例、 安全地编辑字典、调整近壁面网格尺寸、计算入口湍流参数，并读取求解器日志， 告诉你一次计算是收敛还是发散了——而这一切都不需要你离开聊天窗口。

Most of the tools are implemented in pure Python and do not require an OpenFOAM installation, so they can run anywhere whether you leave OpenFOAM installed or not. The few that call OpenFOAM utilities (decidedly, blockMesh, checkMesh) will detect whether the environment exists and degrade gracefully when it is absent.

已在真实的 OpenFOAM(ESI v1912) 环境上完成端到端验证。 生成的算例 跑通了 blockMesh 和所有求解器——simpleFoam 收敛，四种网格预设都产出有效网格， 残差解析器和网格质量解析器也能正确读回真实日志。详见 VALIDATION.md。

OpenFOAM 版本支持

scaffold_case 会接受一个 openfoam_flavor 参数：

• classic（默认）—— 使用 application <solver>; 与 transportProperties。 已在 ESI v1912 上验证；可用于 ESI v2006+ 和 Foundation v8–v10。

• foundation-v12 —— 使用 application foamRun; + solver incompressibleCore; 以及 physicalProperties，用于 OpenFOAM Foundation v11/v12。在这种情况下 应运行 foamRun 而不是实际的求解器名称。

这个插件的意义

搭建一个 CFD 案例本质上充满繁琐的记录工作：合适的 y+，网格与每个 0/ 场之间的 patch 匹配、为所选端流模型准备一致的湍流场、一个平衡的 Courant 数，还有从好几页残差 输出中判断是否已经收敛。这个服务器就把这些折算变成了自然语言对话。

把难做的事变简单

有两款工具做的是大多数人觉得抽象的事情：

• recommend_setup — 用你的话简单描述目标（“for example die 管流”或“汽车受力”）， 它会返回求解器、湍流模型、目标 y+、网格预设、各补丁的边界条件以及一份编号 行动计划——只要被它仍需用到的几个数值。

• generate_blockbeam — 从一组几何预设自动生成一个合法、边界层有渐变（graded） 的 blockMeshDict，你只需要给一个目标高度，它会自动为你计算壁面的渐变。无需手写 vertices 或 blocks。

工具（20 个）

安装与运行

该服务作为以 PyPI 包发布并带命令入口，所以常用的零安装运行方式就是 uvx：

uvx openfoam-mcp

或者也可以把它安装在一个环境中：

pip install openfoam-mcp
openfoam-mcp

Claude Desktop 配置

把以下内容加到你的 claude_desktop_config.json （macOS 路径为 ~/Library/Application Support/Claude/，Windows 为 %APPDATA%\Claude\）：

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

重启 Claude Desktop；OpenFOAM 的工具会与之在工具（tools）菜单中。

提示示例

• "I have air at 30 m/s over a 0.5 m chord. what the Reynolds number that, and first cell height for y+ = 1?"

• "在 ./duct 中用 derived static simpleFoam 搭建一个 12 m/s 的算例并用 checkCase 检查它。"

• "在 ./duct/system/controlDict 中把 endTime 改成 3000。"

• "阅读 ./duct/log.simpleFoam 并告诉我它是否收敛。"

求解器模板

模板遵循 OpenFOAM Foundation v9–v12 / ESI v2306+ 的教程风格（transportProperties

• momentumTransport）。生成的块状网格带有 inlet、outlet、walls、 frontAndBack 这几个 patch。

开发

pip install -e ".[dev]"
pytest

License

MIT © 2026 iLab (Tanawatiraswieng)