OpenFOAM MCP —— 适用任何 MCP 客户端的 CFD 副驾驶

openfoam-mcp 是一个 Model Context Protocol 服务器，它能将 AI 助手（Claude Desktop 以及其他任意 MCP 客户端）变成 OpenFOAM 搭建与调试的副驾驶。它可以搭建可运行的算例、安全地编辑字典文件、计算近壁网格尺寸、算出入口湍流参数，还可以读取求解器日志，告诉你某次仿真到底是收敛了还是崩了这个——全程无需离开聊天界面。

大多数工具都是纯 Python 实现，无需安装 OpenFOAM，因此可以在任何环境中运行。少数需要调用 OpenFOAM 工具（例如 blockMesh、checkMesh）的插件，调用时会先检测环境，若环境中未安装 OpenFOAM，也能友好地降级处理。

为什么有用

搭建 CFD 算例本就涉及繁琐的簿记工作：选择合适的 y/c，保持网格与每个 0/ 场的边界类型匹配，为所选湍流模型配置一致的湍流场，维持稳定的 Courant 数，以及在大量的残差结果中判断计算是否收敛。这个服务器通过自然语言就能替你完成这些枯燥的内容。

工具

安装与运行

该服务器以 PyPI 包的形式发行，并提供命令行入口，因此通常可用 [uvx]（https://docs.astral.sh/uv/）这样的免安装方式运行：

uvx openfoam-mcp

也可以只把它安装到一个环境中：

pip install openfoam-mcp
openfoam-mcp

Claude Desktop 配置

将如下内容加入 claude_desktop_config.json点击三处任一种系统位置（macOS：~/Library/Application Support/ Claude/，Windows：%APPDATA%）：

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

重启 Claude Desktop 后，工具菜单中就能看到这些 OpenFOAM 工具了。

提示词示例

• “一根长 0.5 m 的箔以 30 m/s 的空气… 对应的雷诺数该是多少？若我想要 无常=1，首层网格高度应该取多大？”

• “在 ./duct 下搭建一个 12 m/s 的稳态 simpleFoam 算例，并检查一下。”

• “把 endTime 设为 3000，存入 ./duct/system/controlDict。”

• “读取 ./duct/log.simpleFoam，并说明它是否收敛。”

求解器模板

这些模板遵循 OpenFOAM foundation v9–v12 / v2306+ 的教程风格（使用 transportProperties 与 momentumTransport）。生成的盒体网格带有 inlet、outlet、walls、frontAndBack 四个 patch。

开发

pip install -e ".[dev]"
pytest

许可证

MIT © 2026 年 出处