Codex MCP Abaqus

Utilities and examples for driving Abaqus through a file-based MCP bridge from Codex or other MCP clients.

This project collects the patched Abaqus MCP plugin, MCP stdio server, startup scripts, and a classic finite element example verified on Abaqus 2022.

What Is Included

• src/abaqus_mcp_plugin.py
  Abaqus/CAE kernel-side plugin. It polls command JSON files, executes Abaqus Python code, submits jobs, and writes result JSON files.

• src/mcp_server.py
  MCP server exposing tools such as check_abaqus_connection, execute_script, get_model_info, list_jobs, and submit_job.

• scripts/start_abaqus_mcp_loop.py
  noGUI worker launcher script. Recommended for stable background simulation.

• examples/abaqus_cantilever_classic.py
  Classic 3D cantilever beam static bending example.

• examples/abaqus_tensile_bar_classic.py
  Classic 3D displacement-controlled tensile bar example.

• examples/show_tensile_result_viewport.py
  Visible Abaqus/CAE viewport startup script for the tensile ODB result.

• docs/USAGE.md
  Setup and operating notes.

• docs/TENSILE_MCP_WORKFLOW.md
  End-to-end notes for generating the tensile project, querying it through MCP, and displaying the result in the Abaqus viewport.

Related MCP server: COMSOL MCP Server

Recommended Mode

Use Abaqus noGUI for simulation automation:

abaqus cae noGUI=scripts\start_abaqus_mcp_loop.py

Running MCP inside the Abaqus GUI with Cooperative mode works, but it can make the GUI sluggish because the GUI thread is used for command polling. For most batch simulations, keep the Abaqus window closed and let noGUI produce .cae, .inp, .odb, and summary files.

Quick Start

1. Install the MCP server dependency:

python -m pip install -r requirements.txt

2. Configure the MCP client to run:

[mcp_servers.abaqus]
command = 'python'
args = ['D:\path\to\Codex_MCP_Abaqus\src\mcp_server.py']
cwd = 'D:\path\to\Codex_MCP_Abaqus'

[mcp_servers.abaqus.env]
ABAQUS_MCP_HOME = 'D:\path\to\Codex_MCP_Abaqus'

3. Start Abaqus noGUI worker:

set ABAQUS_MCP_HOME=D:\path\to\Codex_MCP_Abaqus
abaqus cae noGUI=D:\path\to\Codex_MCP_Abaqus\scripts\start_abaqus_mcp_loop.py

4. Check connection from the MCP client:

mcp__abaqus.check_abaqus_connection

Verified Example

The included cantilever example uses:

• Geometry: 100 mm x 10 mm x 10 mm

• Material: linear elastic steel, E = 210000 MPa, nu = 0.3

• Element: C3D8R

• Boundary condition: fixed left end

• Load: vertical surface traction on the right end, equivalent total force 1000 N

Typical result:

• Maximum displacement: about 2.037 mm

• Maximum Mises stress: about 471 MPa

The included tensile example uses:

• Geometry: 100 mm x 10 mm x 10 mm

• Material: linear elastic steel, E = 210000 MPa, nu = 0.3

• Element: C3D8R

• Boundary condition: fixed left end

• Loading: right-end prescribed axial displacement U1 = 1 mm

Typical result:

• Engineering strain: 0.01

• Nominal stress: about 2100 MPa

• Apparent modulus: about 210000 MPa

To display the tensile result in a visible Abaqus/CAE viewport after generating the ODB:

abaqus cae startup=examples\show_tensile_result_viewport.py

Notes

The plugin in this repository includes compatibility fixes for Abaqus 2022's Python 2 kernel:

• Unicode-safe JSON and text writes

• Captured stdout/stderr for execute_script

• Stale heartbeat diagnostics in the MCP server