Ansys Workbench MCP

这是一个用于 Codex / MCP 客户端的 Ansys Workbench 本地桥接项目。它参考了队列 IPC 思路：MCP server 写入命令文件，Workbench 侧 bridge journal 轮询命令并写回结果。

它不是 Ansys 官方项目，也不是通过鼠标点击 Workbench 界面。它封装的是 Ansys 已支持的自动化入口：

• RunWB2.exe -B -R <journal.wbjn>：运行 Workbench journal。
• Workbench scripting：在 Workbench 会话中创建系统、保存/打开/更新项目。
• MAPDL batch：运行 Mechanical APDL 输入文件，用于求解器级自动化验证。

架构

MCP Client / Codex
        |
        | MCP stdio
        v
mcp_server.py
        |
        | file IPC
        v
commands/*.json  --->  ansys_workbench_bridge.wbjn  --->  Workbench
results/*.json   <---  ansys_workbench_bridge.wbjn  <---  Workbench
status.json      <---  bridge heartbeat

当前能力

常驻 bridge 模式

这一模式最接近 Abaqus MCP：

• 启动 Workbench bridge。
• 检查 Workbench bridge 是否在线。
• 在 Workbench 会话内执行脚本。
• 查询当前项目系统和组件信息。
• 打开 Workbench 项目。
• 保存 Workbench 项目。
• 更新 Workbench 项目。
• 创建真实的 Steady-State Thermal 系统。
• 创建并求解一个简单稳态热长方体示例。
• 通过 status.json 暴露 bridge 状态。

直接批处理模式

不启动常驻 bridge，也能执行：

• 运行任意 Workbench journal。
• 创建一个 Workbench Steady-State Thermal 项目。
• 运行 MAPDL 输入文件。
• 创建并求解一个简单稳态热示例。

文件结构

ansys-workbench-mcp/
  mcp_server.py                  # MCP server，负责 stdio 工具和文件 IPC
  ansys_workbench_bridge.wbjn    # Workbench 侧 bridge journal
  stop_mcp.py                    # 从外部停止 bridge
  .mcp.json                      # MCP 客户端示例配置
  requirements.txt               # Python 依赖
  README.md

运行时会生成：

commands/       # MCP server 写入命令
results/        # Workbench bridge 写回结果
scripts/        # 临时脚本
runs/           # 示例工程和求解输出
status.json     # bridge 状态
mcp.log         # bridge 日志
stop.flag       # 停止信号

这些运行时文件不会提交到 Git。

安装

建议安装在：

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_WORKBENCH_MCP_HOME
• 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_WORKBENCH_MCP_HOME = 'D:\ansys-workbench-mcp'
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 server 重新加载。

使用方式

自动启动 Workbench bridge

在 MCP 客户端里调用：

start_workbench_bridge

它会用 RunWB2.exe 加载 ansys_workbench_bridge.wbjn，然后 bridge 会开始轮询 commands/ 目录。

检查连接：

check_workbench_connection

停止 bridge：

stop_workbench_bridge

手动在 Workbench 中加载 bridge

也可以在 Workbench 中手动运行：

File -> Run Script... -> D:\ansys-workbench-mcp\ansys_workbench_bridge.wbjn

该 journal 默认会进入 mcp_loop()，开始监听 MCP 命令。

外部停止 bridge

cd D:\ansys-workbench-mcp
.\.venv\Scripts\python.exe .\stop_mcp.py

MCP 工具

连接和状态

• check_ansys_installation
• start_workbench_bridge
• stop_workbench_bridge
• check_workbench_connection
• ansys-workbench://status
• ansys-workbench://installation

Workbench 会话内工具

• execute_workbench_script
• get_project_info
• open_project
• save_project
• update_project
• create_steady_state_thermal_system_live
• create_thermal_bar_demo_live

直接批处理工具

• run_workbench_journal
• create_steady_state_thermal_system
• run_mapdl_input
• create_and_run_thermal_bar_demo

与 Abaqus MCP 的差异

Abaqus MCP 可以通过 Abaqus/CAE 插件菜单和 Abaqus Python 环境长时间保持 GUI 会话内通信。Workbench 这边没有同等成熟的公开插件模板，所以本项目使用 Workbench journal 作为 bridge。

这意味着：

• 能实现类似的文件 IPC 和会话内脚本执行。
• 可以控制 Workbench 项目原理图、系统创建、保存、更新等。
• Mechanical 细粒度树对象操作还需要继续扩展 Mechanical 脚本接口。
• 复杂 GUI 交互不通过鼠标模拟完成，而应继续封装为脚本工具。

已验证

在本机已经验证：

• MCP stdio 可以列出工具。
• Ansys 2025 R1 路径检查正常。
• start_workbench_bridge 可以启动 Workbench bridge，并通过 ping 响应。
• execute_workbench_script 可以在 Workbench 会话内执行脚本并返回输出。
• get_project_info 可以读取当前 Workbench 项目系统信息。
• create_steady_state_thermal_system_live 可以通过 bridge 创建真实 Workbench 稳态热项目。
• create_thermal_bar_demo_live 可以通过 bridge 完成简单稳态热求解，结果为 525 个节点，温度范围 20 到 100。
• 直接批处理模式可以创建真实 Workbench Steady-State Thermal 项目。
• 直接批处理模式可以完成简单稳态热求解并导出节点温度。

后续计划

• 增加 Mechanical 脚本执行入口。
• 增加导入几何、设置材料、生成网格、施加温度/对流边界条件的高级工具。
• 增加结果图片、温度极值、节点/单元表格导出。
• 增加更多 Workbench/Mechanical 示例脚本。