如何 10 分钟上手 CAE-Agent-Hub:让 Codex 连接真实 Abaqus/CAE 会话的完整新手教程

原创2026-10-15 21:49:332,947 阅读
文章标签:AI 应用MCP 服务AI 技能

如何 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/

CAE-Agent-Hub 中 Codex 连接 Abaqus/CAE 仿真工作流与浏览器 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 .

这个目录里的关键文件:

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,依次让它调用:

  1. ping:验证 socket bridge 已连接,返回 live session 遥测信息;
  2. set_workdir:把 Abaqus 工作目录切到一个干净的分析文件夹;
  3. run_python:执行几行 Abaqus Python,确认脚本可运行;
  4. get_model_info:查看模型、部件、集合、表面、作业与视口;
  5. 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 会逐步完成建模、网格划分和截图验证:

Abaqus/CAE 真实会话中由 AI 通过 CAE-Agent-Hub MCP 生成的圆柱体 O-grid 网格

加分项:不开求解器也能看仿真结果 🖥️

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       # 子弹穿板

CAE-Agent-Hub Text-to-CAE viewer 中的悬臂梁静力分析 Von Mises 应力云图

进阶:用 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,把单软件流程扩展到多求解器组合。
登录后查看全文
CAE-Agent-Hub