su2-mcp

su2-mcp expone la gestión del ciclo de vida de sesiones de SU2, la edición de configuración, la ejecución del solucionador y la inspección de resultados a través de un servidor MCP.

Características

• Gestión del ciclo de vida de sesiones con directorios de trabajo por sesión.

• Utilidades de configuración para leer, analizar y actualizar archivos .cfg de SU2.

• Carga de mallas y sincronización automática de MESH_FILENAME.

• Conversión opcional de malla STEP -> SU2 mediante gmsh (generate_mesh_from_step).

• Envoltorios del solucionador para SU2_CFD y SU2_DEF con manejo de tiempo de espera y binarios faltantes.

• Listado de archivos de resultados, descarga en base64, análisis de CSV de historial y muestreo de superficies.

• Refinamiento de malla de final abierto (2026-06-21): el adaptador CPACS expone las anulaciones opcionales surface_density y farfield_factor además de los tres ajustes predefinidos (laptop/workstation/industry), e informa el recuento real de celdas mesh_n_elem más un indicador cauchy_triggered para que los llamadores puedan construir un bucle de convergencia hasta la meseta (consulta la habilidad SKILL_OPEN_ENDED_MESH.md y scripts/run_converged_su2.py en cmudrc/agent-mcp).

Related MCP server: tigl-mcp

Instalación

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

Ejecutar el servidor

StdIO (predeterminado)

su2-mcp --transport stdio

Transportes 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

Eventos enviados por el servidor (SSE)

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

Los puntos de entrada programáticos están disponibles desde su2_mcp.main.

Desarrollo

make dev
make lint
make type
make test
make docs

Puerta de control completa de estilo CI local:

make ci

Comprobación de binarios de SU2

La herramienta MCP get_su2_status informa de la disponibilidad de los binarios comunes de SU2 (SU2_CFD, SU2_CFD_MPI, SU2_DEF).

Extra opcional de dependencia de SU2

pip install .[su2]

Dependencias del sistema

El paquete de Python es Python puro, pero algunas herramientas dependen de ejecutables externos:

• run_su2_solver / generate_deformed_mesh: requiere binarios de SU2 en PATH

• generate_mesh_from_step: requiere gmsh en PATH

Integración con CPACS compartido

Este MCP incluye un adaptador de CPACS (src/su2_mcp/cpacs_adapter.py) que conecta SU2 con el pipeline de análisis de aeronaves de CPACS compartido.

Qué hace

El adaptador lee la geometría de referencia y las condiciones de vuelo de CPACS, genera mallas de archivos STEP mediante Gmsh, ejecuta simulaciones Euler reales de SU2_CFD, analiza CL/CD desde history.csv y escribe los resultados aerodinámicos en //analysisResults/aero.

Ejecución como parte del pipeline

# 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

Consulta cmudrc/aircraft-analysis para obtener la documentación completa del pipeline, los detalles de versionado y las instrucciones de instalación.

Servidores MCP relacionados

Mantenedores

Mayank Dixit (@Kugel-Blitz-13), Universidad Carnegie Mellon — mayankd@cmu.edu Christopher McComb, Universidad Carnegie Mellon — Colectivo de Investigación de Diseño