# jianzhichun/abaqus-mcp-server architecture

> Architecture diagram of the GitHub repository jianzhichun/abaqus-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jianzhichun/abaqus-mcp-server
- Repository: https://github.com/jianzhichun/abaqus-mcp-server

## Overview

This is an MCP bridge for automating an already-running Abaqus/CAE GUI. The principal workflow is a client submitting Python code, which the server stages and runs through Abaqus’s File → Run Script dialog; the client can then request a best-effort read of Abaqus’s message area to inspect outcomes. The server also exposes a scripting-strategy prompt. The excerpts show window discovery and GUI interaction, but omit portions of script staging and prompt registration, so those details rely on the README where noted.

Main entry points: [`mcp_server.py`](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py) (MCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP interface"]
  node_server["MCP server<br/>[mcp_server.py]"]
  node_script_tool["Script execution tool<br/>[mcp_server.py]"]
  node_log_tool["Message log tool<br/>[mcp_server.py]"]
  node_strategy["Scripting prompt<br/>[mcp_server.py]"]
end

subgraph group_automation["GUI automation"]
  node_discovery["Window discovery<br/>[mcp_server.py]"]
  node_staging["Temporary script file<br/>[mcp_server.py]"]
  node_gui_control["GUI control<br/>[mcp_server.py]"]
end

subgraph group_abaqus["Abaqus application"]
  node_abaqus_gui["Abaqus/CAE GUI"]
  node_message_area["Message/log area"]
end

node_client(("MCP client"))

node_client -->|"sends requests"| node_server
node_server -->|"exposes tool"| node_script_tool
node_server -->|"exposes tool"| node_log_tool
node_server -->|"provides prompt"| node_strategy
node_script_tool -->|"finds window"| node_discovery
node_log_tool -->|"finds window"| node_discovery
node_script_tool -->|"stages code"| node_staging
node_script_tool -->|"automates dialog"| node_gui_control
node_gui_control -->|"submits script"| node_abaqus_gui
node_log_tool -->|"scrapes text"| node_message_area
node_discovery -->|"connects to"| node_abaqus_gui
node_client -->|"consults prompt"| node_strategy

click node_server "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_script_tool "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_log_tool "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_strategy "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_discovery "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_staging "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"
click node_gui_control "https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_script_tool,node_log_tool,node_strategy,node_client toneBlue
class node_discovery,node_staging,node_gui_control toneAmber
class node_abaqus_gui,node_message_area toneMint
```

## Components

### MCP interface

- [MCP server](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`
- [Script execution tool](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`
- [Message log tool](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`
- [Scripting prompt](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`

### GUI automation

- [Window discovery](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`
- [Temporary script file](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`
- [GUI control](https://github.com/jianzhichun/abaqus-mcp-server/blob/main/mcp_server.py): `mcp_server.py`

### Abaqus application

- **Abaqus/CAE GUI**
- **Message/log area**

### Other components

- **MCP client**

## Connections

- MCP client → MCP server: sends requests (evidence: `README.md`)
- MCP server → Script execution tool: exposes tool (evidence: `README.md`)
- MCP server → Message log tool: exposes tool (evidence: `README.md`)
- MCP server → Scripting prompt: provides prompt (evidence: `README.md`)
- Script execution tool → Window discovery: finds window (evidence: `mcp_server.py`)
- Message log tool → Window discovery: finds window (evidence: `mcp_server.py`)
- Script execution tool → Temporary script file: stages code (evidence: `README.md`)
- Script execution tool → GUI control: automates dialog (evidence: `mcp_server.py`)
- GUI control → Abaqus/CAE GUI: submits script (evidence: `mcp_server.py`)
- Message log tool → Message/log area: scrapes text (evidence: `mcp_server.py`)
- Window discovery → Abaqus/CAE GUI: connects to (evidence: `mcp_server.py`)
- MCP client → Scripting prompt: consults prompt (evidence: `README.md`)
