cst-mcp 🛰️

Servidor MCP para CST Studio Suite — diseño de absorbentes metamateriales THz, automatización de celda unitaria y control de puertos Floquet

English | 中文

✨ ¿Qué es esto?

cst-mcp convierte CST Studio Suite en un laboratorio de diseño electromagnético controlable por IA a través del Model Context Protocol. Apunta Claude/Cursor/DSH hacia él y dirige simulaciones de onda completa conversacionalmente:

• 🧱 Constructor de celda unitaria de un solo paso — apilamientos de absorbente MIM (anillo cuadrado / parche / anillo circular), materializa automáticamente puertos Floquet y establece 1 modo por script (~50× más rápido por punto, sin clics en GUI)

• 🎛️ Suite de puertos Floquet con la API correcta de 2026 — número de modos / ángulos de escaneo / polarización, todo scriptable (SetNumberOfModesConsidered, "Zmax" en mayúsculas …). La mayoría de los ejemplos públicos usan una API heredada renombrada que falla silenciosamente en CST 2026 — este servidor está verificado contra CST 2026.

• ⚡ Flujo de diseño rápido de absorbente — establecer parámetros → resolver → espectro de absorción completo de 200 puntos + A_peak / A_min en banda / ancho de banda ≥90 % en una sola llamada de herramienta

• 🔁 Ejecutor de lotes con reanudación por checkpoint — huellas de configuración, bloqueo PID, vigilancia a nivel de punto que sobrevive a cuelgues del solver y a la muerte del canal COM (sobrevivió a más de 2100 puntos sin supervisión)

• 📈 Enlaces de modelo sustituto — predicción de espectro en milisegundos y diseño inverso TopK cuando se proporciona un pipeline entrenado

• 🩺 Autodiagnóstico — herramientas de cola de registro de errores de CST y herramientas de reinicio de sesión para ejecuciones sin supervisión

Related MCP server: hfss-agent-native

🚀 Inicio rápido

pip install -r requirements.txt          # mcp>=1.2,<2  (2.x removed FastMCP path!)
set PYTHONPATH=C:\PATH\TO\CST\AMD64\python_cst_libraries
python src/cst_absorber_mcp.py           # stdio MCP server

Regístrate con tu cliente MCP:

{
  "mcpServers": {
    "cst-mcp": {
      "command": "C:\\CST\\Python\\python.exe",
      "args": ["path/to/src/cst_absorber_mcp.py"],
      "env": { "PYTHONPATH": "C:\\CST\\AMD64\\python_cst_libraries",
               "CST_MCP_WORKDIR": "D:\\cst_mcp_work" }
    }
  }
}

🧰 Herramientas (23)

(consulta los docstrings dentro de src/cst_absorber_mcp.py para las firmas exactas)

📐 Resultados de referencia verificados (ejecuciones reales de CST 2026)

📚 docs/

• reflect_tables.json — tablas de métodos reflejados de objetos COM clave (model3d 387 métodos, FDSolver 112, Material 589, Port 75, FloquetPort 25 …) descubiertos en CST 2026

• results_api_table.json — superficie de API de lectura de parámetros S sin conexión

⚠️ Notas

• Solo Windows (automatización COM); se requiere licencia de CST.

• Mantén las rutas de proyecto solo ASCII — las rutas no ASCII rompen project.save() (error de codificación).

• Usa el SDK de mcp 1.x; v2.0 eliminó la ruta de importación de FastMCP.

中文简介

把 CST Studio Suite 变成 AI 可对话操控的电磁设计实验室：一句话建单元胞（方环/贴片/圆环 MIM）、 脚本化设置 Floquet 端口模数/扫描角/极化（CST2026 正确 API，全网首发实测）、一键求解并返回 200 点吸收谱与指标、断点续跑批量仿真（经 2100+ 点无人值守验证）、可选代理模型毫秒级预测与逆向设计。 安装与配置见上方英文区；工具签名见源码 docstring。

Licencia

MIT — ver LICENSE. CST Studio Suite 是 Dassault Systèmes 产品，本项目仅通过官方 Python 接口驱动。