cst-mcp 🛰️

CST Studio Suite 用 MCP サーバー — THz メタマテリアル吸収体設計、ユニットセル自動化、Floquet ポート制御

英語 | 中国語

✨ これは何ですか？

cst-mcp は、Model Context Protocol を通じて CST Studio Suite を AI で制御可能な電磁設計ラボに変えます。Claude/Cursor/DSH を向けて、会話形式でフルウェーブシミュレーションを駆動します:

• 🧱 ワンショットユニットセルビルダー — MIM 吸収体スタック（正方形リング / パッチ / 円形リング）、Floquet ポートを自動生成し、スクリプトで 1 モードを設定（~50 倍高速、GUI クリック不要）

• 🎛️ 正しい 2026 API を備えた Floquet ポートスイート — モード数 / スキャン角度 / 偏波、すべてスクリプト可能（SetNumberOfModesConsidered、大文字の "Zmax" など）。ほとんどの公開例は、CST 2026 で静かに失敗する名前変更されたレガシー API を使用しています。このサーバーは CST 2026 で検証済みです。

• ⚡ 吸収体クイックデザインワークフロー — パラメータ設定 → ソルバー実行 → 200 点の完全な吸収スペクトル + A_peak / 帯域内 A_min / ≥90% 帯域幅を 1 つのツール呼び出しで

• 🔁 チェックポイント再開バッチランナー — 設定フィンガープリント、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 実行）

📚 ドキュメント/

• 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 インポートパスが削除されました。

中国語の概要

CST Studio Suite を AI と対話的に操作できる電磁設計ラボに変えます。ワンライナーでユニットセル（正方形リング/パッチ/円形リング MIM）を構築し、Floquet ポートのモード数/スキャン角度/偏波をスクリプトで設定（CST2026 正しい API、全ネット初の実測）、ワンクリックでソルバーを実行し 200 点の吸収スペクトルと指標を返し、チェックポイント再開バッチシミュレーション（2100 以上の無人ポイントで検証済み）、オプションの代理モデルによるミリ秒単位の予測と逆設計。インストールと設定は上記の英語セクションを参照。ツールのシグネチャはソースコードの docstring を参照。

ライセンス

MIT — LICENSE を参照。CST Studio Suite は Dassault Systèmes の製品であり、本プロジェクトは公式 Python インターフェースのみを介して駆動します。