OpenFOAM MCP — 모든 MCP 클라이언트를 위한 CFD 코-파일럿

openfoam-mcp는 AI 어시스턴트(Claude Desktop 및 다른 MCP 클라이언트)를 OpenFOAM 설정·디버깅 코-파일럿으로 변환하는 Model Context Protocol 서버입니다. 실행 가능한 케이스를 생성하고, dictionary를 안전하게 편집하며, 벽 근접 메시 크기를 산정하고, 입구 난류 값을 계산하며, 솔버 로그를 읽어 실행이 수렴했는지 발산했는지를 알려줍니다 — 모두 채팅을 떠나지 않고 처리됩니다.

대부분의 도구는 순수 Python이며 OpenFOAM 설치가 필요 없기 때문에 어디서나 동작합니다. OpenFOAM 유틸리티(예: blockMesh, checkMesh)를 호출하는 소수의 도구는 환경을 감지하고, 해당 환경이 없을 때는 부드럽게 기능을 제한합니다.

왜 유용한가

CFD 케이스를 설정하는 것은 번거로운 관리 작업입니다. 올바른 y+, 메시와 모든 0/ 필드 사이에서 경계 패치를 일치시키기, 선택한 모델에 적합한 일관된 난류 필드, 안정적인 Courant 수, 그리고 수렴 여부를 알아보기 위한 여러 페이지의 잔차 출력입니다. 이 서버는 자연어로 그런 관리 작업을 처리합니다.

도구

설치 및 실행

서버는 PyPI 패키지 형태로 콘솔 진입점을 제공하므로, 일반적인 제로-설치 실행기는 ``입니다:

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 도구가 도구 메뉴에 나타납니다.

예시 프롬프트

• "0.5 m 시드(chord)에 30m/s의 공기가 흐릅니다. 이 경우의 레이놀즈 수는 무엇이며, y+ = 1에 필요한 첫 번째 셀 높이는 얼마나 되나요?"

• "SimpleFOAM case를 ./duct에서 정상 상태로 만들고 12 m/s로 실행하도록 배치한 후 점검해 주세요."

• "./duct에서 endTime을 3000으로 설정해 주세요."

• "./duct/log.simpleFoam을 읽고 수렴되었는지 말해 주세요."

솔버 템플릿

이 템플릿들은 OpenFOAM foundation v9 – v12 / ESI v2306+ 튜토리얼 스타일(transportProperties 및 momentumTransport)을 따르며, 생성된 박스 메쉬에는 inlet, outlet, walls, frontAndBack 패치가 있습니다.

개발

pip install -e ".[dev]"
pytest

라이선스

MIT License © 2026 Tanawat Manokieng