cst-mcp 🛰️

面向 CST Studio Suite 的 MCP 服务器 — 太赫兹超材料吸波体设计、单元胞自动化与 Floquet 端口控制

English | 中文

✨ 这是什么？

cst-mcp 通过 Model Context Protocol 将 CST Studio Suite 变成 AI 可控的电磁设计实验室。让 Claude/Cursor/DSH 连接它，即可通过对话驱动全波仿真：

• 🧱 一键单元胞构建器 — MIM 吸波体叠层（方环/贴片/圆环），自动生成 Floquet 端口并通过脚本设置 1 个模式（每点约快 50 倍，无需 GUI 点击）

• 🎛️ 使用正确 2026 API 的 Floquet 端口套件 — 模式数/扫描角/极化，全部可脚本化（SetNumberOfModesConsidered、大写 "Zmax" 等）。大多数公开示例使用的是已更名的旧版 API，在 CST 2026 上会静默失败 — 本服务器已在 CST 2026 上验证通过。

• ⚡ 吸波体快速设计工作流 — 设置参数 → 求解 → 完整 200 点吸收谱 + A_peak / 带内 A_min / ≥90% 带宽，一次工具调用完成

• 🔁 断点续跑批量运行器 — 配置指纹、PID 锁、点级看门狗，可应对求解器挂起和 COM 通道崩溃（已通过 2100+ 无人值守点验证）

• 📈 代理模型钩子 — 提供训练好的流水线时，可实现毫秒级频谱预测与 TopK 逆向设计

• 🩺 自诊断 — CST 错误日志尾部查看工具和会话重启工具，适用于无人值守运行

Related MCP server: hfss-agent-native

🚀 快速开始

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

在你的 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" }
    }
  }
}

🧰 工具（23 个）

（精确签名请参阅 src/cst_absorber_mcp.py 中的 docstring）

📐 已验证的参考结果（真实 CST 2026 运行）

📚 docs/

• reflect_tables.json — 在 CST 2026 上发现的关键 COM 对象反射方法表（model3d 387 个方法、FDSolver 112 个、Material 589 个、Port 75 个、FloquetPort 25 个等）

• results_api_table.json — 离线 S 参数读取 API 接口

⚠️ 注意事项

• 仅支持 Windows（COM 自动化）；需要 CST 许可证。

• 项目路径请保持纯 ASCII — 非 ASCII 路径会导致 project.save() 失败（编码 bug）。

• 请使用 mcp SDK 1.x；v2.0 已移除 FastMCP 导入路径。

中文简介

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

许可证

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