su2-mcp

su2-mcp stellt den SU2-Sitzungslebenszyklus, die Konfigurationsbearbeitung, die Ausführung des Solvers und die Ergebnisseprüfung über einen MCP-Server bereit.

Funktionen

• Sitzungslebenszyklus-Verwaltung mit Arbeitsverzeichnissen pro Sitzung.

• Konfigurationshilfen zum Lesen, Parsen und Aktualisieren von SU2-.cfg-Dateien.

• Mesh-Upload und automatische MESH_FILENAME-Synchronisierung.

• Optionale STEP-zu-SU2-Mesh-Konvertierung über gmsh (generate_mesh_from_step).

• Solver-Wrapper für SU2_CFD und SU2_DEF mit Timeout-/Fehlende-Binärdatei-Behandlung.

• Auflistung von Ergebnisdateien, Base64-Download, CSV-Parsing des Verlaufs und Oberflächenabtastung.

• Offene Mesh-Verfeinerung (2026-06-21): Der CPACS-Adapter stellt optionale surface_density- und farfield_factor-Überschreibungen zusätzlich zu den drei benannten Voreinstellungen (laptop/workstation/industry) bereit und meldet die tatsächliche mesh_n_elem-Zellenzahl sowie ein cauchy_triggered-Flag, sodass Aufrufer eine Konvergiere-bis-zum-Plateau-Schleife aufbauen können (siehe die SKILL_OPEN_ENDED_MESH.md-Fähigkeit und scripts/run_converged_su2.py in cmudrc/agent-mcp).

Related MCP server: tigl-mcp

Installation

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

Server ausführen

StdIO (Standard)

su2-mcp --transport stdio

HTTP-Transports

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

Programmatische Einstiegspunkte sind über su2_mcp.main verfügbar.

Entwicklung

make dev
make lint
make type
make test
make docs

Vollständiger lokaler CI-Gate:

make ci

SU2-Binärdateien prüfen

Das MCP-Tool get_su2_status meldet die Verfügbarkeit gängiger SU2-Binärdateien (SU2_CFD, SU2_CFD_MPI, SU2_DEF).

Optionale SU2-Abhängigkeits-Erweiterung

pip install .[su2]

Systemabhängigkeiten

Das Python-Paket ist reines Python, aber einige Tools sind auf externe ausführbare Dateien angewiesen:

• run_su2_solver / generate_deformed_mesh: erfordert SU2-Binärdateien im PATH

• generate_mesh_from_step: erfordert gmsh im PATH

Shared-CPACS-Integration

Dieses MCP enthält einen CPACS-Adapter (src/su2_mcp/cpacs_adapter.py), der SU2 mit der Shared-CPACS-Flugzeuganalyse-Pipeline verbindet.

Was er tut

Der Adapter liest Referenzgeometrie und Flugbedingungen aus CPACS, erstellt Meshes aus STEP-Dateien über Gmsh, führt echte SU2_CFD-Euler-Simulationen aus, parst CL/CD aus history.csv und schreibt aerodynamische Ergebnisse in //analysisResults/aero.

Ausführung als Teil der 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

Vollständige Pipelinedokumentation, Versionsdetails und Installationsanweisungen finden Sie unter cmudrc/aircraft-analysis.

Verwandte MCP-Server

Betreuer

Mayank Dixit (@Kugel-Blitz-13), Carnegie Mellon University — mayankd@cmu.edu Christopher McComb, Carnegie Mellon University — Design Research Collective