su2-mcp

su2-mcp は、MCP サーバーを介して SU2 セッションのライフサイクル、設定編集、ソルバー実行、結果の検査を公開します。

機能

• セッションごとの作業ディレクトリによるセッションライフサイクル管理。

• SU2 の .cfg ファイルの読み取り、解析、更新のための設定ヘルパー。

• メッシュのアップロードと MESH_FILENAME の自動同期。

• gmsh によるオプションの STEP -> SU2 メッシュ変換 (generate_mesh_from_step)。

• タイムアウト/バイナリ欠落処理を備えた SU2_CFD および SU2_DEF 用ソルバーラッパー。

• 結果ファイルの一覧表示、base64 ダウンロード、履歴 CSV の解析、サーフェスサンプリング。

• オープンエンドなメッシュリファインメント (2026-06-21): CPACS アダプタは、3 つの名前付きプリセット (laptop/workstation/industry) に加えて、オプションの surface_density と farfield_factor のオーバーライドを公開し、実際の mesh_n_elem セル数と cauchy_triggered フラグを報告するため、呼び出し側は収束するまでプラトーを続けるループを構築できます (cmudrc/agent-mcp 内の SKILL_OPEN_ENDED_MESH.md スキルと scripts/run_converged_su2.py を参照)。

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: PATH に SU2 バイナリが必要です

• generate_mesh_from_step: PATH に gmsh が必要です

Shared-CPACS 統合

この MCP には、SU2 を shared-CPACS 航空機解析パイプラインに橋渡しする CPACS アダプタ (src/su2_mcp/cpacs_adapter.py) が含まれています。

機能

アダプタは CPACS から参照形状と飛行条件を読み取り、Gmsh を介して STEP ファイルをメッシュ化し、実際の SU2_CFD オイラーシミュレーションを実行し、history.csv から CL/CD を解析し、空力結果を //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), Carnegie Mellon University — mayankd@cmu.edu Christopher McComb, Carnegie Mellon University — Design Research Collective