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ツールボックスに「定常熱伝導」解析システムを配置することと同等です。

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スクリプト実行エントリーポイントを追加する。

• ジオメトリのインポート、材料の設定、メッシュ生成、温度/対流境界条件の適用を行う高度なツールを追加する。

• 結果画像、温度極値、節点/要素テーブルのエクスポートを追加する。

• より完全なサンプルとテストスクリプトを追加する。