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

openfoam-mcp는 Model Context Protocol 서버로서, AI 어시스턴트(Claude Desktop 및 다른 모든 MCP 클라이언트)를 OpenFOAM 설정·디버깅 코-파일럿으로 만들어 줍니다. 실행 가능한 케이스를 스캐폴딩하고, 딕셔너리(dictionary)를 안전하게 편집하며, 벽면 근접 메시의 크기를 산정하고, 입구 난류 값을 계산하며, 솔버 로그를 읽어 실행이 수렴했는지 발산했는지 알려줍니다 — 채팅창을 벗어나지 않고도 말이죠.

대부분의 도구는 순수 Python이며 OpenFOAM 설치가 필요하지 않으므로 어디서나 작동합니다. OpenFOAM 유틸리티(예: blockMesh, checkMesh)를 호출하는 소수의 도구는 해당 환경을 감지하여 유틸리티가 없는 경우에는 기능을 우아하게 축소합니다.

실제 OpenFOAM(ESI v1912)에서 엔드투엔드로 검증되었습니다. 생성된 케이스가 blockMesh와 솔버를 통과합니다 — simpleFoam이 수렴하고, 네 가지 메시 프리셋 모두 유효한 메시를 생성하며, 실제 로그가 잔차(residual) 및 메시 품질 파서에서 올바르게 다시 읽힙니다. VALIDATION.md를 참조하세요.

OpenFOAM 버전 지원

scaffold_case는 openfoam_flavor를 입력받습니다:

• classic (기본값) — application <solver>; 및 transportProperties 사용. ESI v1912에서 검증되었으며, ESI v2006+ 및 Foundation v8–v10에서도 작동합니다.

• foundation-v12 — OpenFOAM Foundation v11/v12용이며, physicalProperties와 함께 application foamRun; + solver incompressibleFluid;를 사용합니다. 솔버 이름 대신 foamRun을 실행하세요.

왜 유용한가

CFD 케이스를 설정하는 것은 까다로운 장부 정리와 같습니다: 올바른 y+, 메시와 모든 0/ 필드 사이를 일치시키는 경계 패치, 선택한 모델에 일관된 난류 필드, 안정적인 Courant 수, 그리고 수렴 여부를 확인하기 위한 여러 페이지 분량의 잔차 출력 읽기까지 해야 합니다. 이 서버는 자연어로 그 장부 정리를 대신 처리합니다.

어려운 부분을 단순하게 만든다

대부분의 사람이 까다롭다고 여기는 작업을 두 도구가 처리합니다:

• recommend_setup — 목표를 평서한 문장으로 말하면("파이크로 흐르는 흐름", "자동차의 항력") 솔버, 난류 모델, 목표 y+, 메시 프리셋, 패치별 경계 조건, 번호 매겨진 계획과 함께 필요한 숫자만 물어봅니다.

• generate_blockmesh — 지오메트리 프리셋으로부터 유효하고 경계층에 대해 **그레이딩(graded)**된 blockMeshDict를 자동으로 작성합니다. 목표 첫 번째 셀 높이를 입력하면 벽 그레이딩(wall grading)을 계산해 줍니다. 버텍스나 블록을 손으로 작성할 필요가 없습니다.

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

예시 프롬프트

• "0.5 m 시위(chord) 위를 30 m/s로 흐르는 공기가 있습니다. 이때의 Reynolds 수는 얼마이고, y+ = 1에 필요한 첫 번째 셀 높이는 얼마인가요?"

• "./duct에 30 m/s steady simpleFoam 케이스를 스캐폴딩하고 검사하세요."

• "./duct/system/controlDict의 endTime을 3000으로 설정하세요."

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

솔버 템플릿

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

개발

pip install -e ".[dev]"
pytest

라이선스

MIT © 2026 iLab (Tanawat Tanapat)

Hmm, I realize I made some errors in the final draft: I think I accidentally wrote Korean translations for some lines that are wrong (e.g. "특별한" mixed). Let me review and reconstruct the entire final response as a clean Korean translation, ensuring proper correctness.

I need to stop and write the exact final message now, without the flap "Hmm". I'll carefully write final Korean that follows the source.

Let me compile with accurate translations and be careful with the code spans and table.

Key corrections needed:

• "degrees naturally" — no.

• Just write carefully.

I will now write the final answer, with carefully checked rows.

I also note that the original includes a line: "Restart Claude Desktop; the OpenFOAM tools 어머 나타...". We'll write: "Claude Desktop을 다시 시작하면 tools 메뉴에 OpenFOAM 도구가 나타납니다."

Let's produce the output once more,# OpenFOAM MCP by iLab — 모든 MCP 클라이언트를 위한 CFD 코-파일럿

openfoam-mcp는 Model Context Protocol 서버로서, AI 어시스턴트(Claude Desktop 및 다른 모든 MCP 클라이언트)를 OpenFOAM 설정·디버깅 코-파일럿으로 만들어 줍니다. 실행 가능한 케이스를 스캐폴딩하고, 딕셔너리(dictionary)를 안전하게 편집하며, 벽면 근접 메시의 크기를 산정하고, 입구 난류 값을 계산하며, 솔버 로그를 읽어 실행이 수렴했는지 발산했는지 알려줍니다 — 채팅을 벗어나지 않고도 말이죠.

대부분의 도구는 순수 Python만으로 구현되어 OpenFOAM 설치가 필요 없으므로 어디서나 작동합니다. OpenFOAM 유틸리티(예: blockMesh, checkMesh)를 호출하는 소수의 도구는 환경을 감지하고 유틸리티가 없는 환경에서는 우아하게 기능을 축소합니다.

실제 OpenFOAM(ESI v1912)에서 엔드투엔드로 검증되었습니다. 생성된 케이스가 blockMesh 및 솔버를 통과합니다 — simpleFoam이 수렴하고, 네 가지 메시 프리셋 모두 유효한 메시를 생성하며, 실제 로그가 잔차(residual) 및 메시 품질 파서에 올바르게 다시 읽힙니다. 문서는 VALIDATION.md를 참고하시기 바랍니다.

OpenFOAM 버전 지원

scaffold_case는 openfoam_flavor를 입력받습니다:

• classic (기본값) — transportProperties와 함께 application <solver>; 구문을 사용합니다. ESI v1912에서 검증했고, ESI v2006+ 및 Foundation v8–v10에서도 동작합니다.

• foundation-v12 — physicalProperties와 함께 application foamRun; + solver incompressibleFluid;를 사용하는 OpenFOAM Foundation v11/v12용입니다. 솔버 이름 대신 foamRun을 실행하세요.

왜 유용한가

CFD 케이스를 설정하는 일은 까다로운 기록 작업입니다. 올바른 y+ 요구, 메시와 모든 0/ 필드의 경계 패치를 일치시키기, 선택한 난류 모델과 일관된 난류장을 만들기, 안정적인 Courant 수 유지, 그리고 수렴 여부를 확인하기 위해 수십 페이지의 잔차 로그를 읽는 일이 요구됩니다. 이 서버는 자연어를 통해 그런 관리 작업을 대신합니다.

어려운 부분 손쉽게

많은 사람이 가장 손이 가는 작업을 두 도구가 처리합니다:

• recommend_setup — 목표를 일반 말로 전달하면("파이프 내부 흐름", "자동차에 작용하는 항력") 솔버, 난류 모델, 목표 y+, 메시 프리셋, 패치별 경계 조건과 번호가 매겨진 계획을 커한다이 반환합니다. 부족한 물만 질문합니다.

• generate_blockmesh — 지오메트리 프리셋부터 유효하면서도 경계층에 대해 **등급 조정(graded)**된 blockMeshDict를 자동 작성합니다. 목표 첫 번째 셀 높이를 알려주면 벽 등급(wall grading)을 스스로 계산합니다. verte와 block을 손으로 쓸 필요가 없습니다.

도구 (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을 다시 시작하면 도구(tools) 메뉴에서 OpenFOAM 도구들이 나타납니다.

예시 프롬프트

• “0.5 m 시위(chord) 위로 30 m/s의 공기가 흐르고 있다. 그 Reynolds 수와, y+ = 1을 위한 첫 번째 cell 높이를 얼마인가?”

• “./duct에 12 m/s의 steady simpleFoam 케이스를 scaffold 하고 검사해 줘.”

• “./duct/system/controlDict에서 endTime을 3000으로 설정해 줘.”

• “./duct/log.simpleFoam을 읽고 수렴 여부를 알려 줘.”

솔버 템플릿

템플릿은 OpenFOAM Foundation v9–v12 / ESI v2306+, 이상의 튜토리얼 스타일(함yticalFuncsProp + momentumTransport)을 따릅니다. 생성되는 box 메시는 inlet, outlet, walls, frontAndBack의 패치를 갖게 됩니다.

개발

pip install -e ".[dev]"
pytest

라이선스

MIT © 2026 iLab (Tanwat Tanapatput)