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 适配器在三个命名预设（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

服务器发送事件（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 中

共享-CPACS 集成

该 MCP 包含一个 CPACS 适配器（src/su2_mcp/cpacs_adapter.py），用于将 SU2 与共享-CPACS 飞行器分析流程进行桥接。

功能说明

该适配器从 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），卡内基梅隆大学 — mayankd@cmu.edu Christopher McComb，卡内基梅隆大学 — 设计研究集体