cst-mcp 🛰️

MCP-Server für CST Studio Suite — THz-Metamaterialabsorber-Design, Einheitszellen-Automatisierung und Floquet-Port-Steuerung

English | 中文

✨ Was ist das?

cst-mcp verwandelt CST Studio Suite über das Model Context Protocol in ein KI-steuerbares elektromagnetisches Designlabor. Richte Claude/Cursor/DSH darauf aus und steuere Vollwellen-Simulationen per Konversation:

• 🧱 One-Shot-Einheitszellen-Builder — MIM-Absorber-Stapel (Quadratring / Patch / Kreisring), legt Floquet-Ports automatisch an und setzt 1 Modus per Skript (~50× schneller pro Punkt, keine GUI-Klicks)

• 🎛️ Floquet-Port-Suite mit der korrekten 2026-API — Moduszahl / Scanwinkel / Polarisation, alles per Skript steuerbar (SetNumberOfModesConsidered, "Zmax" …). Die meisten öffentlichen Beispiele nutzen eine umbenannte Legacy-API, die unter CST 2026 stillschweigend fehlschlägt – dieser Server ist gegen CST 2026 verifiziert.

• ⚡ Absorber-Schnellentwurfs-Workflow — Parameter setzen → lösen → vollständiges 200-Punkte-Absorptionsspektrum mit A_peak, In-Band-A_min und ≥90 % Bandbreite in einem Tool-Aufruf

• 🔁 Checkpoint-Resume-Batch-Runner — Parameter-Fingerprints, PID-Sperre, Watchdog auf Punktebene, der Solver-Hänger und COM-Kanalausfälle übersteht (hat 2100+ unbeaufsichtig Punkte überlebt)

• 📈 Surrogatmodell-Hooks — Spektrumsvorhersage in Millisekunden und TopK-Inversdesign, sobald eine trainierte Pipeline bereitgestellt wird

• 🩺 Selbstdiagnose — Werkzeuge für den CST-Fehlerprotokoll-Ende und Session-Neustart-Werkzeuge für unbeaufsichtigte Läufe

Related MCP server: hfss-agent-native

🚀 Schnellstart

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

Registriere ihn bei deinem MCP-Client:

{
  "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" }
    }
  }
}

🧰 Werkzeuge (23)

(die genauen Signaturen siehe Docstrings in src/cst_absorber_mcp.py)

📐 Verifizierte Referenzergebnisse (reale CST-2026-Läufe)

📚 docs/

• reflect_tables.json — reflektierte Methodentabellen der zentralen COM-Objekte (model3d 387 Methoden, FDSolver 112, Material 589, Port 75, FloquetPort 25 …), erfasst auf CST 2026

• results_api_table.json — Offline-S-Parameter-Lesen-API-Registrierung

⚠️ Hinweise

• Nur Windows (COM-Automation); CST-Lizenz erforderlich.

• Projektpfade nur ASCII — Pfade mit nicht-ASCII-Zeichen bringen project.save() zum Abstürzen (Kodierungsfehler).

• MCP-SDK 1.x verwenden; v2.0 hat den FastMCP-Importpfad entfernt.

Kurzeinführung auf Chinesisch

Macht CST Studio Suite zu einem per KI-Dialog steuerbaren elektromagnetischen Designlabor: Einheitszellen lassen sich mit einem einzigen Satz anlegen (Quadratring – Ringstück – Kreisring-MIM), Floquet-Ports (Moduszahl / Upt-Schwenkwinkel / Polarisation) per Skript setzen – mit korrekter, für CST-2026 verifizierter API –, per Knopfdruck lösen und das Spektrum mit 200-Punkt-Apsorptionskennzahlen zurückgeben; Batch-Simulation mit Checkpoint/Resume (über 2100+ unbeaufsichtig Punkte verifiziert) fortsetzen. Optional ein gelerntes Surrogatmodell für Millisekunden-Vorhersagen und inverses Design. Installationshinweise und Konfiguration siehe oben; Toolsignaturen stehen in den Docstrings des Quellcodes.

🤝 License

MIT – siehe LICENSE. CST Studio Suite ist ein Produkt von Dassault Systèmes; dieses Projekt steuert es aussendlich über die offizielle Python-Schnittstelle an.