Ansys Workbench MCP

Dies ist ein lokaler MCP-Server für Codex, der dazu dient, Ansys Workbench, Mechanical und MAPDL mittels Skripten zu steuern.

Es handelt sich weder um ein offizielles Ansys-Projekt, noch erfolgt die Steuerung durch Mausklicks auf die Workbench-Oberfläche. Es kapselt die von Ansys bereits unterstützten Automatisierungsschnittstellen:

• RunWB2.exe -B -R <journal.wbjn>: Batch-Ausführung von Workbench-Journals.

• Workbench-Scripting: Erstellung echter Steady-State Thermal-Projektsysteme.

• MAPDL-Batch: Ausführung von Mechanical APDL-Eingabedateien zur Automatisierung und Validierung auf Solver-Ebene.

Aktueller Status

Die aktuelle Version ist eine minimal funktionsfähige Version, mit der die Steuerungsverbindung von Codex zu Workbench validiert werden kann:

• Überprüfung der Pfade für Workbench, Mechanical und MAPDL.

• Ausführung beliebiger Workbench-Journals.

• Erstellung eines echten Workbench Steady-State Thermal-Systems.

• Ausführung von MAPDL-Eingabedateien.

• Erstellung und Lösung eines einfachen Beispiels für einen stationären thermischen Quader.

Es handelt sich noch nicht um eine vollständige End-to-End-Struktur wie bei Abaqus MCP. Abaqus MCP verfügt über Abaqus/CAE-Plugins, Befehlsverzeichnisse, Ergebnisverzeichnisse und weitere In-Session-Abfragetools; diese Workbench-Version nutzt zunächst die Journal-/Batch-Schnittstellen. Zukünftig können Mechanical-Skriptausführung, Modellbaumabfragen, Netz-/Lastkapselung und Ergebnisexport-Tools erweitert werden.

Related MCP server: fluent-research-mcp

Installation

Empfohlene Installation unter:

D:\ansys-workbench-mcp

Erstellen Sie eine virtuelle Umgebung und installieren Sie die Abhängigkeiten:

cd D:\ansys-workbench-mcp
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

Ansys-Pfade

Die lokale Konfiguration basiert derzeit auf Ansys 2025 R1:

Workbench:  D:\Program Files\ANSYS Inc\v251\Framework\bin\Win64\RunWB2.exe
Mechanical: D:\Program Files\ANSYS Inc\v251\aisol\bin\winx64\AnsysWBU.exe
MAPDL:      D:\Program Files\ANSYS Inc\v251\ansys\bin\winx64\ANSYS251.exe

Falls Ihr Installationspfad abweicht, können Sie diesen über Umgebungsvariablen überschreiben:

• ANSYS_RUNWB2

• ANSYS_MECHANICAL

• ANSYS_MAPDL

Codex-Konfiguration

Fügen Sie den folgenden Inhalt zur Codex-Konfigurationsdatei hinzu:

%USERPROFILE%\.codex\config.toml

[mcp_servers.ansys-workbench]
command = 'D:\ansys-workbench-mcp\.venv\Scripts\python.exe'
args = ['D:\ansys-workbench-mcp\mcp_server.py']
cwd = 'D:\ansys-workbench-mcp'
startup_timeout_sec = 30
tool_timeout_sec = 600
enabled = true

[mcp_servers.ansys-workbench.env]
ANSYS_RUNWB2 = 'D:\Program Files\ANSYS Inc\v251\Framework\bin\Win64\RunWB2.exe'
ANSYS_MECHANICAL = 'D:\Program Files\ANSYS Inc\v251\aisol\bin\winx64\AnsysWBU.exe'
ANSYS_MAPDL = 'D:\Program Files\ANSYS Inc\v251\ansys\bin\winx64\ANSYS251.exe'

Starten Sie Codex nach der Änderung der Konfiguration neu, damit der MCP-Server neu geladen wird.

MCP-Tools

check_ansys_installation

Überprüft, ob die Pfade zu den ausführbaren Dateien von Workbench, Mechanical und MAPDL existieren.

run_workbench_journal

Führt das angegebene .wbjn Workbench-Journal über RunWB2.exe aus.

create_steady_state_thermal_system

Erstellt ein echtes Workbench Steady-State Thermal-System und speichert die .wbpj-Projektdatei. Diese Aktion entspricht dem Platzieren eines "Steady-State Thermal"-Analysesystems in der Workbench-Toolbox.

run_mapdl_input

Führt eine Mechanical APDL-Eingabedatei mittels MAPDL-Batch aus.

create_and_run_thermal_bar_demo

Erstellt und löst ein einfaches Beispiel für einen stationären thermischen Quader, um zu validieren, ob die Workbench / MAPDL-Automatisierungskette funktionsfähig ist.

Validierung

Lokal bereits validiert:

• Der MCP-stdio-Handshake kann Tools auflisten.

• check_ansys_installation kann den Pfad zu Ansys 2025 R1 erkennen.

• create_steady_state_thermal_system kann ein echtes Workbench-Projekt für stationäre Wärme erstellen.

• create_and_run_thermal_bar_demo kann eine einfache stationäre thermische Lösung durchführen und die Knotentemperaturergebnisse exportieren.

Zukünftige Pläne

• Hinzufügen eines Einstiegspunkts für die Mechanical-Skriptausführung.

• Hinzufügen fortgeschrittener Tools für den Geometrieimport, die Materialzuweisung, die Netzgenerierung sowie das Aufbringen von Temperatur-/Konvektionsrandbedingungen.

• Hinzufügen des Exports von Ergebnisbildern, Temperatur-Extremwerten sowie Knoten-/Elementtabellen.

• Hinzufügen vollständigerer Beispiele und Testskripte.