[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80748":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},80748,"Abaqus-Control-MCP","Whfkl\u002FAbaqus-Control-MCP","Whfkl","让 AI 可以驱动 Abaqus建模。Connect Claude, Cursor, and other MCP clients directly to your active Abaqus\u002FCAE session.","",null,"Python",92,11,41,1,0,44,48,51,132,3.24,"MIT License",false,"main",true,[],"2026-06-12 02:04:06","# Abaqus Control MCP\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.10%2B-blue)](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n\n[中文](README_ZH.md) | English\n\n> **Let AI drive Abaqus directly.** Describe the model you want — geometry, materials, loads, steps — and let the AI work inside your live Abaqus\u002FCAE session.\n\n**Abaqus Control MCP** connects Claude Code, Codex, Antigravity, and any other MCP-compatible client to a running Abaqus\u002FCAE instance. You describe the task, the AI translates it into Abaqus actions, and the model updates in real time.\n\n> **Older Abaqus versions** ship Python 2. If your Abaqus uses Python 2, use the [Python 2 compatible fork](https:\u002F\u002Fgithub.com\u002Fhp283260133-bit\u002FAbaqus-Control-MCP-abaqus2021) instead.\n\n### Why this?\n\n- **Work directly in the live GUI** — actions run in your active Abaqus window, so geometry, mesh, and results stay visible as they change.\n- **Full access to Abaqus objects** — `mdb`, `session`, `odb`, and the rest of the Python API are directly available, letting AI do the work.\n- **Keep the session interactive** — engineers can inspect progress at any time without stopping the session.\n- **Stay local** — the bridge listens on `127.0.0.1:48152`, so nothing leaves your machine.\n- **Use any MCP client** — Claude Code, Codex, Antigravity, and other compatible clients can all connect.\n\n\n## Setup\n\n**AI agent one-click install**\n\nIf your AI agent supports natural-language installation, just prompt it with:\n\n```text\ninstall https:\u002F\u002Fgithub.com\u002FWhfkl\u002FAbaqus-Control-MCP\n```\n\n**1. Install the package**\n\nYou can install the package directly via Git, or from a cloned repository in your local directory.\n\n**Option A: Remote Git Install (direct install)**\n\n`uv` (recommended):\n\n```bash\nuv tool install git+https:\u002F\u002Fgithub.com\u002FWhfkl\u002FAbaqus-Control-MCP.git\n```\n\nOr `pip`:\n\n```bash\npip install git+https:\u002F\u002Fgithub.com\u002FWhfkl\u002FAbaqus-Control-MCP.git\n```\n\n---\n\n**Option B: Local Directory Install (run inside the cloned project root)**\n\n*   **Standard Local Install**\n\n    `uv` (recommended):\n    ```bash\n    uv tool install .\n    ```\n    Or `pip`:\n    ```bash\n    pip install .\n    ```\n\n*   **Development Mode (editable install)**\n    If you plan to modify the source code and have changes apply dynamically:\n\n    `uv` (recommended):\n    ```bash\n    uv tool install --editable .\n    ```\n    Or `pip`:\n    ```bash\n    pip install -e .\n    ```\n\nDependencies 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.\n\n**2. Install the GUI plugin**\n\nRun the following command to install automatically:\n\n```bash\nabaqus-control-setup\n```\n\nAlternatively, you can **manually** copy `abaqus_mcp_bridge\u002Fgui_plugin.py` from the project source to your Abaqus plugins directory (typically `~\u002Fabaqus_plugins\u002F`).\n\n> [!NOTE]\n> You can override the target folder for both automatic and manual installations by setting the `ABAQUS_MCP_PLUGIN_DIR` environment variable.\n\n**3. Start Abaqus\u002FCAE, activate the plugin**\n\n```\nPlug-ins → Abaqus-Control-MCP → Start MCP Bridge\n```\n\n**4. Configure your MCP client**\n\nDepending on the AI agent you use, add the MCP server configuration to the corresponding config file.\n\n#### Option A: Claude Code (Claude CLI)\n\nAdd the following entry to the `mcpServers` section in `~\u002F.claude.json`:\n\n```json\n\"abaqus-control-mcp\": {\n  \"command\": \"abaqus-control-mcp-server\",\n  \"env\": {\n    \"ABAQUS_MCP_HOST\": \"127.0.0.1\",\n    \"ABAQUS_MCP_PORT\": \"48152\",\n    \"ABAQUS_MCP_TIMEOUT\": \"120\"\n  }\n}\n```\n\n> Note: Add to the `mcpServers` section in `~\u002F.claude.json` (global) or under `projects.\u003Cpath>.mcpServers` for a specific project. Claude Code starts the MCP server automatically when you open a session.\n\n#### Option B: Antigravity (Gemini\u002FAntigravity IDE)\n\nAdd the following entry to the `mcpServers` section in `~\u002F.gemini\u002Fconfig\u002Fmcp_config.json`. Specifying an absolute path is recommended (replace `\u003CUsername>` with your system username):\n\n```json\n\"abaqus-control-mcp\": {\n  \"command\": \"abaqus-control-mcp-server\",\n  \"env\": {\n    \"ABAQUS_MCP_HOST\": \"127.0.0.1\",\n    \"ABAQUS_MCP_PORT\": \"48152\",\n    \"ABAQUS_MCP_TIMEOUT\": \"120\"\n  }\n}\n```\n\n**5. Verify**\n\n```bash\nabaqus-control-check\n```\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `ping` | Check connectivity + session state (models, viewports, PID) |\n| `run_python` | Execute arbitrary Python code in the Abaqus kernel |\n| `monitor_job_status` | List jobs or tail `.sta`\u002F`.msg` for progress and diagnostics |\n| `inspect_odb` | Open ODB read-only: sliced frames, variables with components |\n| `capture_viewport` | Capture viewport screenshot as base64 (PNG\u002FJPEG\u002FTIFF\u002FSVG) |\n| `set_workdir` | Change the Abaqus working directory |\n\n> Model creation, job submission, field\u002Fhistory output extraction — all go through `run_python`. Its error payload includes the traceback, error line, code excerpt, and recovery hints.\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `ABAQUS_MCP_HOST` | `127.0.0.1` | TCP bridge host |\n| `ABAQUS_MCP_PORT` | `48152` | TCP bridge port |\n| `ABAQUS_MCP_TIMEOUT` | `120` | Execution timeout in seconds |\n| `ABAQUS_MCP_PLUGIN_DIR` | `~\u002Fabaqus_plugins` | GUI plugin target directory |\n\n## Python API\n\n```python\nfrom abaqus_mcp_bridge.client import AbaqusBridgeClient\n\nclient = AbaqusBridgeClient(timeout=60)\nresult = client.execute(\"from abaqus import mdb; result = list(mdb.models.keys())\")\nprint(result['return_value'])  # ['Model-1', ...]\n```\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| `WinError 10061` Connection refused | The bridge service is not running in Abaqus\u002FCAE. Please **first start Abaqus\u002FCAE**, and select **Plug-ins -> Abaqus-Control-MCP -> Start MCP Bridge** from the top menu, then try again. |\n| `Permission denied` \u002F `os error 5` during install or update | An old `abaqus-control-mcp-server` process is still running in the background (used and locked by Claude Code\u002FCursor). Close the MCP client (such as Claude Code or Cursor) or manually terminate the process in Task Manager to release the file lock, then try installing again. |\n| MCP client says `Connection closed` \u002F Server crashes with `ModuleNotFoundError: No module named 'pydantic_core.core_schema'` | The dependency packages (e.g. `pydantic_core`) in the default Python environment (e.g. Python 3.13) selected by the `uv` tool runner are corrupted or missing DLLs on Windows. Force a reinstall using another installed Python version: `uv tool install --force --python 3.14 .` |\n| `command not found: abaqus-control-mcp-server` | Reinstall or run `abaqus-control-doctor` |\n| No output from server | Normal for stdio MCP server — it doesn't print to stdout |\n| `Module abaqusGui can only be used in Abaqus\u002FCAE GUI` | Use **Plug-ins** menu, not File → Run Script |\n| Connection timed out | Start the Abaqus plugin **before** the MCP server |\n| Model doesn't appear in GUI | Run `abaqus-control-check` — verify `\"thread\": \"MainThread\"` |\n| Claude Code doesn't see MCP tools | 1. Run `claude mcp list` to check if `abaqus` is registered. 2. If not listed, add the MCP config as described in Step 4. 3. Restart Claude Code after any config change. |\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","Abaqus Control MCP 项目让 AI 能够直接驱动 Abaqus 进行建模。通过将 Claude、Cursor 等 MCP 客户端与活跃的 Abaqus\u002FCAE 会话连接起来，用户可以描述所需的模型参数（如几何形状、材料、载荷和步骤），由 AI 在实时的 Abaqus 环境中执行相应的操作。该项目支持全访问 Abaqus 对象，包括 `mdb`、`session` 和 `odb` 等，并保持会话的交互性，使工程师能够随时检查进度。此外，它仅在本地运行，确保数据安全。适用于需要高效自动化处理复杂工程模拟任务的场景，尤其是希望利用自然语言指令来简化建模流程的专业人士。",2,"2026-06-11 04:01:53","CREATED_QUERY"]