su2-mcp

su2-mcp предоставляет управление жизненным циклом сессий SU2, редактирование конфигураций, выполнение решателя и просмотр результатов через MCP-сервер.

Возможности

• Управление жизненным циклом сессий с отдельными рабочими каталогами для каждой сессии.

• Вспомогательные функции конфигурации для чтения, разбора и обновления файлов .cfg SU2.

• Загрузка сетки и автоматическая синхронизация MESH_FILENAME.

• Необязательное преобразование STEP в сетку SU2 через gmsh (generate_mesh_from_step).

• Обёртки решателя для SU2_CFD и SU2_DEF с обработкой тайм-аута и отсутствующих бинарных файлов.

• Просмотр файлов результатов, загрузка в base64, разбор CSV-истории и выборка по поверхности.

• Открытое уточнение сетки (2026-06-21): адаптер CPACS предоставляет необязательные переопределения surface_density и farfield_factor поверх трёх именованных пресетов (laptop/workstation/industry) и сообщает фактическое количество ячеек mesh_n_elem плюс флаг cauchy_triggered, чтобы вызывающие могли построить цикл «сходиться до плато» (см. навык SKILL_OPEN_ENDED_MESH.md и scripts/run_converged_su2.py в cmudrc/agent-mcp).

Related MCP server: tigl-mcp

Установка

python3 -m venv .venv
source .venv/bin/activate
pip install -e .[dev]

Запуск сервера

StdIO (по умолчанию)

su2-mcp --transport stdio

HTTP-транспорты

su2-mcp --transport http --host 0.0.0.0 --port 8002 --path /mcp
su2-mcp --transport streamable-http --host 0.0.0.0 --port 8002 --streamable-http-path /mcp

Server-Sent Events (SSE)

su2-mcp --transport sse --host 0.0.0.0 --port 8000 --mount-path / --sse-path /sse

Программные точки входа доступны из su2_mcp.main.

Разработка

make dev
make lint
make type
make test
make docs

Полный локальный CI-подобный шлюз:

make ci

Проверка бинарных файлов SU2

Инструмент MCP get_su2_status сообщает о доступности распространённых бинарных файлов SU2 (SU2_CFD, SU2_CFD_MPI, SU2_DEF).

Необязательная дополнительная зависимость SU2

pip install .[su2]

Системные зависимости

Пакет Python является чисто Python, но некоторые инструменты полагаются на внешние исполняемые файлы:

• run_su2_solver / generate_deformed_mesh: требуют бинарные файлы SU2 в PATH

• generate_mesh_from_step: требует gmsh в PATH

Интеграция с Shared-CPACS

Этот MCP включает адаптер CPACS (src/su2_mcp/cpacs_adapter.py), который связывает SU2 с конвейером анализа самолётов shared-CPACS.

Что он делает

Адаптер читает эталонную геометрию и условия полёта из CPACS, создаёт сетку STEP-файлов через Gmsh, запускает реальные симуляции Эйлера SU2_CFD, анализирует CL/CD из history.csv и записывает аэродинамические результаты в //analysisResults/aero.

Запуск в составе конвейера

# Classic preset path
python pipeline/shared_cpacs_orchestrator.py D150_v30.xml \
    --mcps tigl su2 pycycle nseg --su2-preset workstation

# Custom one-off density (open-ended override)
python pipeline/shared_cpacs_orchestrator.py D150_v30.xml \
    --mcps tigl su2 --su2-density 120

# Converged delivery: refine surface_density until CL/CD plateau
python pipeline/shared_cpacs_orchestrator.py D150_v30.xml \
    --mcps tigl su2 --su2-converge

См. cmudrc/aircraft-analysis для полной документации конвейера, сведений о версионировании и инструкций по установке.

Связанные MCP-серверы

Сопровождающие

Mayank Dixit (@Kugel-Blitz-13), Университет Карнеги-Меллона — mayankd@cmu.edu Christopher McComb, Университет Карнеги-Меллона — Design Research Collective