cst-mcp 🛰️

CST Studio Suite용 MCP 서버 — THz 메타물질 흡수체 설계, 단위 셀 자동화 및 Floquet 포트 제어

English | 中文

✨ 이게 뭔가요?

cst-mcp는 Model Context Protocol을 통해 CST Studio Suite를 AI로 제어 가능한 전자기 설계 랩으로 바꿔줍니다. Claude/Cursor/DSH를 연결하면 대화형으로 full-wave 시뮬레이션을 구동할 수 있습니다:

• 🧱 원샷 단위 셀 빌더 — MIM 흡수체 스택(사각 링 / 패치 / 원형 링), Floquet 포트 자동 생성 및 스크립트로 1 모드 설정(~50배 빠른 포인트당 속도, GUI 클릭 불필요)

• 🎛️ 올바른 2026 API를 사용하는 Floquet 포트 스위트 — 모드 수 / 스캔 각도 / 편파, 모두 스크립트 가능(SetNumberOfModesConsidered, 대문자 "Zmax" …). 대부분의 공개 예제는 CST 2026에서 조용히 실패하는 이름이 바뀐 레거시 API를 사용합니다 — 이 서버는 CST 2026에서 검증되었습니다.

• ⚡ 흡수체 빠른 설계 워크플로우 — 파라미터 설정 → 해석 → 전체 200포인트 흡수 스펙트럼 + A_peak / 대역 내 A_min / ≥90 % 대역폭을 한 번의 도구 호출로 제공

• 🔁 체크포인트 재개 배치 러너 — 구성 지문, PID 잠금, 솔버 중단 및 COM 채널 사망을 견디는 포인트 수준 워치독(2100+ 무인 포인트 검증 완료)

• 📈 대리 모델 훅 — 훈련된 파이프라인이 제공되면 밀리초 단위 스펙트럼 예측 및 역설계 TopK

• 🩺 자가 진단 — 무인 실행을 위한 CST 오류 로그 tail 도구 및 세션 재시작 도구

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()를 깨뜨립니다(인코딩 버그).

• mcp SDK 1.x 사용; v2.0은 FastMCP import 경로를 제거했습니다.

中文简介

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

라이선스

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