Ansys Workbench MCP

Este es un servidor MCP local para Codex, utilizado para controlar Ansys Workbench, Mechanical y MAPDL mediante scripts.

No es un proyecto oficial de Ansys, ni funciona mediante clics de ratón en la interfaz de Workbench. Encapsula las entradas de automatización ya soportadas por Ansys:

• RunWB2.exe -B -R <journal.wbjn>: Ejecución por lotes de diarios de Workbench.

• Workbench scripting: Creación de sistemas de proyectos reales de Steady-State Thermal.

• MAPDL batch: Ejecución de archivos de entrada de Mechanical APDL para validación de automatización a nivel de solver.

Estado actual

La versión actual es una versión mínima funcional que puede verificar el enlace de control de Codex a Workbench:

• Comprobar las rutas de Workbench, Mechanical y MAPDL.

• Ejecutar cualquier diario de Workbench.

• Crear un sistema real de Steady-State Thermal en Workbench.

• Ejecutar archivos de entrada de MAPDL.

• Crear y resolver un ejemplo simple de barra térmica en estado estacionario.

Todavía no es una estructura completa de doble extremo como Abaqus MCP. En Abaqus MCP existen plugins de Abaqus/CAE, directorios de comandos, directorios de resultados y más herramientas de consulta dentro de la sesión; esta versión de Workbench utiliza primero la interfaz de diario / procesamiento por lotes, y posteriormente se puede seguir expandiendo con ejecución de scripts de Mechanical, consulta del árbol de modelos, encapsulación de malla/cargas y herramientas de exportación de resultados.

Instalación

Se recomienda instalar en:

D:\ansys-workbench-mcp

Cree un entorno virtual e instale las dependencias:

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

Rutas de Ansys

La máquina local está configurada actualmente para 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

Si su ruta de instalación es diferente, puede sobrescribirla con variables de entorno:

• ANSYS_RUNWB2

• ANSYS_MECHANICAL

• ANSYS_MAPDL

Configuración de Codex

Añada el siguiente contenido al archivo de configuración de Codex:

%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'

Reinicie Codex después de modificar la configuración para que el servidor MCP se recargue.

Herramientas MCP

check_ansys_installation

Comprueba si existen las rutas de los ejecutables de Workbench, Mechanical y MAPDL.

run_workbench_journal

Ejecuta el diario de Workbench .wbjn especificado a través de RunWB2.exe.

create_steady_state_thermal_system

Crea un sistema real de Steady-State Thermal en Workbench y guarda el archivo de proyecto .wbpj. Esta acción es equivalente a colocar un sistema de análisis "térmico en estado estacionario" en el cuadro de herramientas de Workbench.

run_mapdl_input

Ejecuta un archivo de entrada de Mechanical APDL mediante el procesamiento por lotes de MAPDL.

create_and_run_thermal_bar_demo

Crea y resuelve un ejemplo simple de barra térmica en estado estacionario para verificar si el enlace de automatización de Workbench / MAPDL está disponible.

Verificado

Ya verificado en la máquina local:

• El handshake de stdio de MCP puede listar las herramientas.

• check_ansys_installation puede detectar la ruta de Ansys 2025 R1.

• create_steady_state_thermal_system puede crear un proyecto real de térmica en estado estacionario de Workbench.

• create_and_run_thermal_bar_demo puede completar la resolución térmica simple en estado estacionario y exportar los resultados de temperatura de los nodos.

Planes futuros

• Añadir una entrada para la ejecución de scripts de Mechanical.

• Añadir herramientas avanzadas para importar geometría, configurar materiales, generar mallas y aplicar condiciones de contorno de temperatura/convección.

• Añadir exportación de imágenes de resultados, valores extremos de temperatura y tablas de nodos/elementos.

• Añadir ejemplos más completos y scripts de prueba.