Abaqus智能建模控制器

Setup

AI agent one-click install

If your AI agent supports natural-language installation, just prompt it with:

install https://github.com/Whfkl/Abaqus-Control-MCP

1. Install the package

You can install the package directly via Git, or from a cloned repository in your local directory.

Option A: Remote Git Install (direct install)

uv (recommended):

uv tool install git+https://github.com/Whfkl/Abaqus-Control-MCP.git

Or pip:

pip install git+https://github.com/Whfkl/Abaqus-Control-MCP.git

---

Option B: Local Directory Install (run inside the cloned project root)

• Standard Local Install

uv (recommended):

    uv tool install .
    

    pip install .
    

* Development Mode (editable install) If you plan to modify the source code and have changes apply dynamically:

uv (recommended):

    uv tool install --editable .
    

    pip install -e .
    

Dependencies are declared in pyproject.toml — no requirements.txt needed. Any of the methods above will install the four CLI commands (abaqus-control-mcp-server, abaqus-control-check, abaqus-control-doctor, abaqus-control-setup) to your global environment or active virtual environment.

2. Install the GUI plugin

Run the following command to install automatically:

abaqus-control-setup

Alternatively, you can manually copy abaqus_mcp_bridge/gui_plugin.py from the project source to your Abaqus plugins directory (typically ~/abaqus_plugins/).

[!NOTE] You can override the target folder for both automatic and manual installations by setting the ABAQUS_MCP_PLUGIN_DIR environment variable.

3. Start Abaqus/CAE, activate the plugin

Plug-ins → Abaqus-Control-MCP → Start MCP Bridge

4. Configure your MCP client

Depending on the AI agent you use, add the MCP server configuration to the corresponding config file.

Option A: Claude Code (Claude CLI)

Add the following entry to the mcpServers section in ~/.claude.json:

"abaqus-control-mcp": {
  "command": "abaqus-control-mcp-server",
  "env": {
    "ABAQUS_MCP_HOST": "127.0.0.1",
    "ABAQUS_MCP_PORT": "48152",
    "ABAQUS_MCP_TIMEOUT": "120"
  }
}

Note: Add to the mcpServers section in ~/.claude.json (global) or under projects.<path>.mcpServers for a specific project. Claude Code starts the MCP server automatically when you open a session.

Option B: Antigravity (Gemini/Antigravity IDE)

Add the following entry to the mcpServers section in ~/.gemini/config/mcp_config.json. Specifying an absolute path is recommended (replace <Username> with your system username):

"abaqus-control-mcp": {
  "command": "C:/Users/<Username>/.local/bin/abaqus-control-mcp-server.exe",
  "env": {
    "ABAQUS_MCP_HOST": "127.0.0.1",
    "ABAQUS_MCP_PORT": "48152",
    "ABAQUS_MCP_TIMEOUT": "120"
  }
}

5. Verify

abaqus-control-check

Environment Variables

Python API

from abaqus_mcp_bridge.client import AbaqusBridgeClient

client = AbaqusBridgeClient(timeout=60)
result = client.execute("from abaqus import mdb; result = list(mdb.models.keys())")
print(result['return_value'])  # ['Model-1', ...]

Troubleshooting