Ansys Workbench MCP

이것은 Codex를 위한 로컬 MCP 서버로, 스크립트 방식을 통해 Ansys Workbench, Mechanical 및 MAPDL을 제어하는 데 사용됩니다.

이 프로젝트는 Ansys 공식 프로젝트가 아니며, Workbench 인터페이스를 마우스로 클릭하여 제어하는 방식이 아닙니다. Ansys에서 이미 지원하는 자동화 진입점을 래핑한 것입니다:

• RunWB2.exe -B -R <journal.wbjn>: Workbench 저널을 배치 모드로 실행합니다.

• Workbench scripting: 실제 Steady-State Thermal 프로젝트 시스템을 생성합니다.

• MAPDL batch: 솔버 수준의 자동화 검증을 위해 Mechanical APDL 입력 파일을 실행합니다.

현재 상태

현재 버전은 최소 기능 버전으로, Codex에서 Workbench로의 제어 링크를 검증할 수 있습니다:

• Workbench, Mechanical, MAPDL 경로 확인.

• 임의의 Workbench 저널 실행.

• 실제 Workbench Steady-State Thermal 시스템 생성.

• MAPDL 입력 파일 실행.

• 간단한 정상 상태 열 해석 직육면체 예제 생성 및 해석.

이 버전은 아직 Abaqus MCP와 같은 완전한 양방향 구조는 아닙니다. Abaqus MCP에는 Abaqus/CAE 플러그인, 명령 디렉토리, 결과 디렉토리 및 더 많은 세션 내 쿼리 도구가 포함되어 있습니다. Workbench 버전은 현재 저널/배치 인터페이스를 우선적으로 사용하며, 향후 Mechanical 스크립트 실행, 모델 트리 쿼리, 메시/하중 래핑 및 결과 내보내기 도구로 확장할 수 있습니다.

설치

다음 위치에 설치하는 것을 권장합니다:

D:\ansys-workbench-mcp

가상 환경을 생성하고 의존성을 설치합니다:

cd D:\ansys-workbench-mcp
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

Ansys 경로

본 기기는 현재 Ansys 2025 R1으로 구성되어 있습니다:

Workbench:  D:\Program Files\ANSYS Inc\v251\Framework\bin\Win64\RunWB2.exe
Mechanical: D:\Program Files\ANSYS Inc\v251\aisol\bin\winx64\AnsysWBU.exe
MAPDL:      D:\Program Files\ANSYS Inc\v251\ansys\bin\winx64\ANSYS251.exe

설치 경로가 다른 경우 환경 변수로 덮어쓸 수 있습니다:

• ANSYS_RUNWB2

• ANSYS_MECHANICAL

• ANSYS_MAPDL

Codex 구성

다음 내용을 Codex 구성 파일에 추가하십시오:

%USERPROFILE%\.codex\config.toml

[mcp_servers.ansys-workbench]
command = 'D:\ansys-workbench-mcp\.venv\Scripts\python.exe'
args = ['D:\ansys-workbench-mcp\mcp_server.py']
cwd = 'D:\ansys-workbench-mcp'
startup_timeout_sec = 30
tool_timeout_sec = 600
enabled = true

[mcp_servers.ansys-workbench.env]
ANSYS_RUNWB2 = 'D:\Program Files\ANSYS Inc\v251\Framework\bin\Win64\RunWB2.exe'
ANSYS_MECHANICAL = 'D:\Program Files\ANSYS Inc\v251\aisol\bin\winx64\AnsysWBU.exe'
ANSYS_MAPDL = 'D:\Program Files\ANSYS Inc\v251\ansys\bin\winx64\ANSYS251.exe'

구성을 수정한 후 Codex를 재시작하여 MCP 서버를 다시 로드하십시오.

MCP 도구

check_ansys_installation

Workbench, Mechanical, MAPDL 실행 파일 경로가 존재하는지 확인합니다.

run_workbench_journal

RunWB2.exe를 통해 지정된 .wbjn Workbench 저널을 실행합니다.

create_steady_state_thermal_system

실제 Workbench Steady-State Thermal 시스템을 생성하고 .wbpj 프로젝트 파일을 저장합니다. 이 작업은 Workbench 도구 상자에서 '정상 상태 열(Steady-State Thermal)' 해석 시스템을 배치하는 것과 동일합니다.

run_mapdl_input

MAPDL 배치 처리를 사용하여 Mechanical APDL 입력 파일을 실행합니다.

create_and_run_thermal_bar_demo

간단한 정상 상태 열 해석 직육면체 예제를 생성하고 해석하여 Workbench / MAPDL 자동화 링크가 사용 가능한지 검증합니다.

검증 완료

본 기기에서 다음 사항이 검증되었습니다:

• MCP stdio 핸드셰이크를 통해 도구 목록 확인 가능.

• check_ansys_installation으로 Ansys 2025 R1 경로 확인 가능.

• create_steady_state_thermal_system으로 실제 Workbench 정상 상태 열 프로젝트 생성 가능.

• create_and_run_thermal_bar_demo로 간단한 정상 상태 열 해석을 완료하고 노드 온도 결과를 내보내기 가능.

향후 계획

• Mechanical 스크립트 실행 진입점 추가.

• 형상 가져오기, 재질 설정, 메시 생성, 온도/대류 경계 조건 설정 등을 위한 고급 도구 추가.

• 결과 이미지, 온도 극값, 노드/요소 테이블 내보내기 기능 추가.

• 더 완전한 예제 및 테스트 스크립트 추가.