Ansys Workbench MCP

Это локальный MCP-сервер для Codex, предназначенный для управления Ansys Workbench, Mechanical и MAPDL с помощью скриптов.

Это не официальный проект Ansys, и он не имитирует клики мышью в интерфейсе Workbench. Он использует официально поддерживаемые интерфейсы автоматизации Ansys:

• RunWB2.exe -B -R <journal.wbjn>: пакетный запуск журналов Workbench.

• Скрипты Workbench: создание полноценных систем проектов Steady-State Thermal.

• Пакетный режим MAPDL: запуск входных файлов Mechanical APDL для автоматизированной проверки на уровне решателя.

Текущее состояние

Текущая версия является минимально жизнеспособной и позволяет проверить цепочку управления от Codex к Workbench:

• Проверка путей к Workbench, Mechanical и MAPDL.

• Запуск любого журнала Workbench.

• Создание полноценной системы Steady-State Thermal в Workbench.

• Запуск входных файлов MAPDL.

• Создание и решение простого примера установившегося теплового состояния прямоугольного бруска.

Это еще не полноценная двусторонняя структура, как в Abaqus MCP. В Abaqus MCP есть плагин Abaqus/CAE, каталоги команд, каталоги результатов и дополнительные инструменты запросов внутри сессии; данная версия для Workbench пока использует интерфейсы журналов/пакетной обработки, в дальнейшем можно расширить функционал для выполнения скриптов Mechanical, запросов к дереву модели, инструментов для работы с сеткой/нагрузками и экспорта результатов.

Установка

Рекомендуется устанавливать в:

D:\ansys-workbench-mcp

Создайте виртуальное окружение и установите зависимости:

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

Пути к Ansys

На данной машине текущая конфигурация соответствует 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

Если ваш путь установки отличается, вы можете переопределить его с помощью переменных окружения:

• ANSYS_RUNWB2

• ANSYS_MECHANICAL

• ANSYS_MAPDL

Конфигурация Codex

Добавьте следующее содержимое в файл конфигурации 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'

После изменения конфигурации перезапустите Codex, чтобы MCP-сервер перезагрузился.

Инструменты MCP

check_ansys_installation

Проверяет наличие исполняемых файлов Workbench, Mechanical и MAPDL по указанным путям.

run_workbench_journal

Выполняет указанный журнал Workbench .wbjn через RunWB2.exe.

create_steady_state_thermal_system

Создает полноценную систему Steady-State Thermal в Workbench и сохраняет файл проекта .wbpj. Это действие эквивалентно перетаскиванию системы анализа «Установившееся тепловое состояние» (Steady-State Thermal) из панели инструментов Workbench.

run_mapdl_input

Запускает входной файл Mechanical APDL в пакетном режиме MAPDL.

create_and_run_thermal_bar_demo

Создает и решает простой пример установившегося теплового состояния прямоугольного бруска для проверки работоспособности цепочки автоматизации Workbench / MAPDL.

Проверено

На данной машине проверено следующее:

• Рукопожатие MCP stdio позволяет перечислить инструменты.

• check_ansys_installation корректно определяет пути Ansys 2025 R1.

• create_steady_state_thermal_system создает реальный проект установившегося теплового состояния Workbench.

• create_and_run_thermal_bar_demo успешно выполняет расчет установившегося теплового состояния и экспортирует результаты температуры в узлах.

Планы на будущее

• Добавить точку входа для выполнения скриптов Mechanical.

• Добавить продвинутые инструменты для импорта геометрии, настройки материалов, генерации сетки, задания граничных условий температуры/конвекции.

• Добавить экспорт изображений результатов, экстремальных значений температуры, таблиц узлов/элементов.

• Добавить более полные примеры и тестовые скрипты.