如何 10 分钟上手 CAE-Agent-Hub:让 Codex 连接真实 Abaqus/CAE 会话的完整新手教程
如何 10 分钟上手 CAE-Agent-Hub:让 Codex 连接真实 Abaqus/CAE 会话的完整新手教程
CAE-Agent-Hub 是一个开源的 CAE MCP Server 与 Agent Skill 集合,让 Codex、Cursor、Claude Code 等 AI 客户端直接连接 Abaqus/CAE、ANSYS Fluent 等真实 CAE 软件,完成建模、提交作业、读取 ODB 结果、截取视口截图等操作。这篇新手教程带你走一遍最短路径:克隆仓库、注册 MCP Server、启动 Abaqus/CAE socket bridge,约 10 分钟让 Codex 操控你正在运行的 Abaqus 会话。
CAE-Agent-Hub 是什么 🧭
用一张链路图理解它的架构:AI 客户端把指令交给 MCP Server,MCP Server 通过本地 TCP bridge 转发给正在运行的 CAE 软件,求解器返回原生结果:
AI client
-> MCP server 或 skill instruction
-> 正在运行的 CAE 应用(Abaqus/CAE)
-> 原生求解结果
-> 轻量 viewer 数据
-> 浏览器检查或报告工作流
仓库由四部分组成:
| 模块 | 作用 | 路径 |
|---|---|---|
| MCP Server | 给 AI 客户端真实的"手",操作 CAE 软件 | MCP/ |
| Agent Skills | 可复用的建模、分析、验证工作流指令 | Skill/ |
| 示例案例 | Text to CAE 演示案例数据 | models/ |
| 浏览器 viewer | 不打开求解器也能查看仿真结果 | viewer/ |
上图是它典型的真实使用形态:AI 客户端生成并执行建模脚本,浏览器 viewer 则展示悬臂梁、孔板、球形冲击、齿轮啮合等案例的应力云图与网格结果。
第一步:3 步准备好项目(约 5 分钟)⚡
准备工作:
- 机器上有可用且授权的 Abaqus/CAE
- 已安装 Python 3 与一个支持 MCP 的 AI 客户端(Codex / Cursor 等)
1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/ca/CAE-Agent-Hub
cd CAE-Agent-Hub
2. 创建虚拟环境并安装 Abaqus MCP
cd MCP\Abaqus
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U pip
.\.venv\Scripts\python.exe -m pip install -e .
这个目录里的关键文件:
- mcp_server.py:在 Abaqus 外部运行的 MCP Server,通过 stdio 暴露工具;
- abaqus_mcp_plugin.py:在 Abaqus/CAE 内部运行,启动本地 TCP socket bridge;
- abaqus_plugins/mcp_control/:Abaqus GUI 菜单加载器。
3. 在 Codex 中注册 MCP Server
参照 examples/mcp_config.example.json,把 <repo> 替换为你本地 MCP\Abaqus 目录的绝对路径:
{
"mcpServers": {
"abaqus-mcp-server": {
"command": "<repo>\\.venv\\Scripts\\python.exe",
"args": ["<repo>\\mcp_server.py"],
"cwd": "<repo>",
"env": {
"ABAQUS_MCP_HOST": "127.0.0.1",
"ABAQUS_MCP_PORT": "48152",
"ABAQUS_MCP_TIMEOUT": "60",
"ABAQUS_MCP_HOME": "<repo>"
}
}
}
}
💡 bridge 默认监听
127.0.0.1:48152;若端口被占用,在客户端配置里修改ABAQUS_MCP_PORT即可。
第二步:启动 Abaqus/CAE 的 Socket Bridge(约 2 分钟)
启动 Abaqus/CAE,从菜单启动 bridge:
Plug-ins > Abaqus MCP > Start Socket Bridge
如果菜单没有出现,把 abaqus_v6.env.example 复制到家目录作为 abaqus_v6.env,设置环境变量 ABAQUS_MCP_HOME 指向 MCP\Abaqus 目录,重启 Abaqus/CAE 即可在启动时自动加载菜单。
此时完整通信链路为:
MCP client
<stdio MCP>
mcp_server.py
<local TCP JSON, 默认 127.0.0.1:48152>
Abaqus/CAE GUI bridge
<AFX timeout dispatcher + sendCommand>
Abaqus kernel
由于 bridge 直接在 GUI 线程处理请求、再通过 sendCommand 进入 Abaqus kernel,不再有文件轮询,交互式建模非常实时。
第三步:验证连接并跑第一个任务(约 3 分钟)✅
切回 Codex,依次让它调用:
ping:验证 socket bridge 已连接,返回 live session 遥测信息;set_workdir:把 Abaqus 工作目录切到一个干净的分析文件夹;run_python:执行几行 Abaqus Python,确认脚本可运行;get_model_info:查看模型、部件、集合、表面、作业与视口;capture_viewport:截取视口截图,让 AI"看到"你的模型。
Abaqus MCP 核心工具一览:
| 工具 | 用途 |
|---|---|
ping |
验证 socket bridge 与会话状态 |
run_python |
执行 Abaqus Python,返回结构化结果和错误诊断 |
set_workdir |
建模或提交作业前切换工作目录 |
get_model_info / list_jobs |
查看模型信息与作业列表 |
submit_job / monitor_job_status |
提交作业并监控 .sta、.msg 状态 |
inspect_odb |
读取 ODB 元数据与可用输出变量 |
capture_viewport |
返回视口截图 |
连通之后,就可以让 Codex 干点实事,比如:"在 Abaqus 里建一个圆柱体,划分 O-grid 网格,并截个视口图"——AI 会逐步完成建模、网格划分和截图验证:
加分项:不开求解器也能看仿真结果 🖥️
models/ 下每个案例只要包含 result_mesh.json,就能直接在浏览器里查看。启动 viewer:
cd viewer
npm install
npm run dev
打开 Vite 输出的地址(默认 http://127.0.0.1:4178/),通过 URL 参数浏览内置案例:
?case=cantilever # 悬臂梁静力
?case=hole-plate # 孔板静力
?case=hole-plate-modal # 孔板模态
?case=sphere-impact # 球体冲击
?case=gear-mesh # 齿轮啮合
?case=bullet-plate # 子弹穿板
进阶:用 Skills 和更多求解器扩展能力 🧩
想让 AI 做得更深,可以把 Skill/abaqus/ 下的技能目录复制到客户端 skill 目录,例如 abaqus-static-analysis、abaqus-mesh、abaqus-odb,AI 会按技能完成从几何到后处理的完整工作流。示例提示词:
Use the abaqus-static-analysis, abaqus-mesh, abaqus-job, and abaqus-odb skills. Build a complete Abaqus static-analysis workflow, run it if the Abaqus MCP or local Abaqus CLI is available, and report the exact files and commands used.
此外 MCP/ 目录还内置了 ANSYS Fluent、Workbench Mechanical、AEDT/HFSS、HyperWorks、CalculiX、LAMMPS、OVITO 等 MCP Server,配置方式一致,照各子目录 README 操作即可。更多细节见 MCP/Abaqus/README.zh-CN.md。
常见问题速查 🛠️
| 症状 | 原因与解决 |
|---|---|
ping 提示连接被拒 |
bridge 未启动:确认已在 Abaqus 菜单中点击 Start Socket Bridge |
| 端口被占用 | 修改 ABAQUS_MCP_PORT,保持客户端与 bridge 配置一致 |
| 命令超时 | 求解等长操作超过 ABAQUS_MCP_TIMEOUT(默认 60 秒),可适当调大 |
| 插件菜单不显示 | 未自动加载:检查 abaqus_v6.env 与 ABAQUS_MCP_HOME 是否配置正确 |
到这里,你已经完成了 Codex 与真实 Abaqus/CAE 会话的连接。推荐下一步:
- 通读 MCP/Abaqus/README.zh-CN.md,掌握全部 MCP 工具与资源(
abaqus://status等); - 复制 Skill/abaqus/analysis/ 下的静力、模态、疲劳等分析技能,让 AI 自主完成完整工作流;
- 探索 MCP/ 中 Fluent、Workbench、CalculiX 等其他 MCP Server,把单软件流程扩展到多求解器组合。


