convez.ai
MCP ServerAutomaçãoAvançado
yesooner

Hyper-Dyna-MCP

yesooner/hyper-dyna-mcp

Automação de HyperMesh GUI via Claude com rotas Tcl verificadas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP especializado em automação da GUI do HyperMesh, permitindo que Claude Code/Codex enviem rotas Tcl verificadas para o listener HyperMesh local. Suporta criação de elementos finitos (HEX8, TET4, QUAD4, TRIA3, BAR2), geometrias e ações de modelagem como atribuição de material, propriedade, restrições e cargas para simulações LS-DYNA.

Instalação

$npx convez-ai yesooner/hyper-dyna-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
19
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v2.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de pré-processamento FEA em HyperMesh via Claude Code
  • Geração programática de malhas de elementos finitos e geometrias
  • Atribuição automatizada de materiais, propriedades e condições de contorno
  • Aceleração de fluxos de trabalho LS-DYNA através de modelagem inteligente

Veredito

Ferramenta especializada e bem-estruturada para quem trabalha com HyperMesh e precisa de automação via Claude. Requer conhecimento técnico em FEA, Tcl e arquitetura MCP, mas oferece integração verificada e confiável com suporte a casos de uso reais de simulação.

README

A tradução para o português deste README ainda está na fila.

Hyper-Dyna-MCP

Hyper-Dyna-MCP 是一个面向本机 HyperMesh GUI 的 MCP server。它通过 FastMCP + stdio 接入 Claude Code / Codex,并把经过验证的 Tcl 路线发送到正在运行的 HyperMesh GUI listener。

当前范围只包含 HyperMesh GUI 自动化。LS-DYNA 求解器、LS-PrePost、hmbatch、后端写 K 文件和 K 文件导出都不是当前 MCP 执行能力。

当前状态

  • 版本:2.0.0
  • MCP 传输:FastMCP + stdio
  • 运行目标:本机 HyperMesh GUI listener
  • 默认端口:47883
  • 可用 FE 创建:HEX8、TET4、QUAD4 shell、TRIA3、BAR2/BEAM、DISCRETE spring、MASS element
  • 可用几何创建:surface plate、geometry solid box(verified *solidblock route)
  • 可用建模 action:assign_material、assign_property、assign_section、assign_eos、apply_constraint、apply_load
  • 默认阻断:*tetmesh、surface automesh、line mesh、mixed mesh、K export;复杂卡片(如 MAT_3、LOAD_BLAST)仍需验证

工作流程

Hyper-Dyna-MCP Workflow

快速使用

1. 配置 Claude Code / Codex

在 Claude Code 或 Codex 的 MCP 配置文件中添加以下内容,让它知道如何启动本项目的 MCP server:

{
  "mcpServers": {
    "hyper-dyna-mcp": {
      "command": "<python>",
      "args": ["-m", "program.server"],
      "cwd": "<repo-root>",
      "env": {
        "PYTHONPATH": "<repo-root>"
      }
    }
  }
}

Claude Code / Codex 会通过 stdio(标准输入输出)与 MCP server 通信,不需要手动启动 Web 服务。

2. 启动 HyperMesh Listener

两种方式:

方式 A:GUI 界面启动(推荐)

首次需要在 HyperMesh Tcl Console 中加载脚本:

source "<repo-root>/hmcustom.tcl"

加载后会自动创建 MCP 标签页,点击 Start MCP(Socket 模式)或 Start Loop(IPC 模式)即可。

方式 B:Tcl Console 手动启动

在 HyperMesh 中打开 Tcl Console(菜单 View → Tcl Console),执行:

set ::mcp_hm_port 47883
source "<repo-root>/runs/hm_gui_listener.tcl"

成功时返回 HYPERMESH_MCP_PONG。如果端口被占用:

catch {mcp_stop}
if {[llength [info commands mcp_start_on_port]]} {mcp_start_on_port 47884} else {source "<repo-root>/runs/hm_gui_listener_47884.tcl"}

常用工具

优先使用:

hm_modeling_action
hm_element_capability_matrix
hm_command_map
hm_gui_modeling_smoke
hm_visual_refresh
hm_auto_save
check_hypermesh_connection
diagnose_hypermesh_listener
set_hypermesh_listener_port

直接创建工具:

hm_create_fe_cube
hm_create_surface_plate
hm_create_shell_plate
hm_create_tet4
hm_create_tria3
hm_create_beam_line
hm_create_discrete_spring
hm_create_lumped_mass
hm_create_solid_box

LS-DYNA keyword 查询只用于规划和校验:

dyna_keyword_policy
dyna_keyword_map_validate
dyna_keyword_query
hm_set_keyword

建模 Action

hm_modeling_action 是 agent 建模的首选入口,支持以下 action:

Action功能curated keywords
create_mesh创建结构化 FE 网格HEX8、QUAD4 shell
create_element创建直接 FE elementTET4、TRIA3、BAR2/BEAM、DISCRETE、MASS
assign_material分配材料MAT_ELASTIC
assign_property / assign_section分配属性/截面SECTION_SOLID、SECTION_SHELL、SECTION_BEAM、SECTION_DISCRETE
assign_eos分配 EOSEOS_LINEAR_POLYNOMIAL
apply_constraint施加约束BOUNDARY_SPC、BOUNDARY_SPC_SET
apply_load施加载荷LOAD_NODE、LOAD_SEGMENT、LOAD_SHELL 及其 set 变体
recording_requirements查看录制要求用于 blocked route 的下一步
validate_recording校验录制证据promotion 闭环

材料分配支持所有元素类型:solid_hex、solid_tet、shell_quad、shell_tria、line_beam、lumped_mass、discrete。未被 curated 的复杂卡片(如 MAT_3、LOAD_BLAST)仍保持 blocked。

功能范围

类型当前状态
HEX8 structured FE已开放,走 verified Tcl route
TET4 / TRIA3 direct element已开放,只创建直接 FE element,不是自动网格
QUAD4 shell plate已开放,结构化 FE shell,不做 surface automesh
BAR2/BEAM line已开放,创建新直线和 BEAM element
DISCRETE / MASS已开放,基础 FE element 创建
Geometry surface已开放
Geometry solid box已开放,走 verified *solidblock route
材料/property/section/EOS/约束/LOAD已开放,走 hm_set_keyword GUI Tcl 模板;复杂卡片仍需验证
*tetmesh / surface automesh / line mesh / mixed_mesh_workflow未开放,需要 command recording
K export未开放,不能用后端 K writer 代替 GUI 导出

FE 网格、几何实体和 K 文件是不同路线。Agent 必须优先走 HyperMesh GUI listener 和 verified route;program.tools.k_writer、program.tools.k_parser、program.tools.hm_k_integration 只能作为离线 fixture/test/review,不能绕过 GUI 建模或伪装成最终 .k 导出。

关键文件

program/server.py                 MCP server entry
program/tools/hm_gui.py           GUI listener client and diagnostics
program/tools/hm_model_writer.py  FE modeling helpers
program/tools/hm_command_map.py   verified HyperMesh Tcl route map
program/tools/dyna_keyword_map.py structured LS-DYNA keyword policy
program/claude_smoke.py           MCP smoke test
runs/hm_gui_listener.tcl          HyperMesh Tcl listener
templates/hm_command_map.json     HyperMesh route definitions
templates/dyna_keyword_map.json   LS-DYNA keyword route definitions

边界

  • 不猜测未验证的 HyperMesh Tcl 命令。
  • 不通过当前 MCP 执行 LS-DYNA、LS-PrePost 或 hmbatch。
  • 不把 Dyna manual 文本或 embedding 当作执行依据。
  • 不用 K writer/parser/integration 绕过 HyperMesh GUI。
  • 不提交 .claude/、.codex/、本机 MCP JSON、商业软件路径、token、proxy 或本机 path YAML。

许可证

本项目使用 GNU Affero General Public License v3.0,见 LICENSE。

Ver o original no GitHub

Bom para

Relacionados