cst-sim-agent

Versión en chino

Un plugin de Claude Code que convierte CST Studio Suite en un asistente conversacional de simulación electromagnética mediante MCP.

La IA para la Ciencia (AI4S) está empujando la IA desde "conversar" hacia "hacer realmente investigación e ingeniería".

En la simulación electromagnética, el verdadero cuello de botella es este: un agente necesita manejar software profesional como CST, pero no puede comunicarse con él con fluidez — incluso después de una conexión exitosa, no conoce los nombres correctos de los métodos VBA ni las express idioms de Python adaptadas a CST. Los LLM de propósito general nunca fueron entrenados para operar CST; escribir código directamente produce métodos fantasma inventados, y un solo error (10091) puede hacerte perder horas.

cst-sim-agent resuelve esto con un diseño de tres capas: un conjunto de herramientas MCP permite que el lenguaje natural lleve el modelado → la asignación de materiales → la configuración de puertos → la resolución → la lectura de resultados; una base de conocimientos de dominio integrada (biblioteca de sintaxis VBA de 8 dominios, 158 ejemplos oficiales, listas de comprobación de errores comunes) permite que el agente consulte y las use directamente — sin tener que releer documentación técnica, volver a aprender los ajustes de la interfaz o incluso reaprender la física al cambiar de dominio de aplicación, como le pasaría a un ingeniero humano; ganchos de restricción que consultan la biblioteca antes de escribir VBA y revisan la ventana de mensajes de CST después de la ejecución, protegiendo contra alucinaciones y fallos silenciosos. En la práctica de validación de extremo a extremo, este mecanismo completó cerca de 20 proyectos de simulación multimétodo en 2 días (modelado, cambio de métodos, comparación paramétrica) — el mismo trabajo llevaría semanas con un flujo puramente manual. Más importante aún, el mecanismo se auto-evoluciona con tu uso: cada error que encuentras y cada experiencia que validas se reconsolida en la base de conocimientos al cerrar, formando un bucle de "usar → consolidar → reutilizar": cuanto más se us, más inteligentes se vuelve y más fluidas resultan las tareas similares.

Nuestra visión es llevar la IA para la ciencia al escritorio de simulación de ingenieros e investigadores — no para reemplazarlos, sino para ampliar la capacidad humana de hacer ciencia mediante la simulación física: deja al agente las operaciones repetitivas, mecánicas y el aprendizaje transversal entre dominios, sigue reservando a los humanos el diseño electromagnético y el juicio físico, y libera a los ingenieros humanos.

Mejoras

Related MCP server: CST Studio Orchestrator MCP

Madurez y verificación

Este plugin nació de varios proyectos de automatización de CST, alternan iteraciones internas y pasó una prueba blindada independiente antes de su primer lanzamiento público. Cobertura verificada: instalación y hooks, conexión real a una instancia de CST, el tutorial oficial de la antena de parche de extremo a extremo, base de conocimientos y revisión de residuos. Aún no cubierta del todo: compatibilidad multi-versiones de CST, modelos más complejos y más combinaciones de herramientas — esto necesita ser validado en comunidad por desarrolladores.

El ejemplo oficial de extremo a extremo (antena circular de parche, 2–3 GHz) completó el flujo: resonancia de S @11 en 2.40 GHz, coindentando con el valor de referencia del tutorial oficial de CST (≈2,4 GHz). Ver el informe de verificación.

Las decisiones de tecnología y diseño (canal VBA como principal, soporte con la API oficial) se documentan en el documento de arquitectura.

Requisitos de la premisa

• Windows (la interfaz COM de CST vive en Windows)

• CST Studio Suite 2024/2025/2026 (2026 recomendada; versiones antiguas deberían funcionar pero no se han verificado individualmente)

• Python 3.10+ (con el launcher py de Windows incluido con el instalador Python oficial; el servidor MCP se puede iniciar mediante py -3 y no guarda que python esté en la PATH)

• Dependencias de Python: pip install -r requirements.txt (mcp, pywin32)

Resolución de la ruta para la librería Python oficial de CST (src/controller.py, src/connection.py):

1. Lee primero la variable de entorno CST_INSTALL_DIR (debe apuntar a la raíz de CST, p. ej. C:\Program Files\CST Studio Suite 2026)

2. Si no está, detecta automáticamente ubicaciones comunes de instalación (C:\Program Files\CST Studio Suite 202x, etc.)

Es recomendable configurar la variable de entorno CST_INSTALL_DIR para obtener la resolución más confiable de la ruta.

Instalación

# Option 1: install from the GitHub marketplace (available after publishing to GitHub)
claude plugin marketplace add https://github.com/<your-name>/cst-sim-agent
claude plugin install cst-sim-agent@cst-sim-agent

# Option 2: install from a local directory (development / offline)
claude plugin marketplace add /path/to/cst-sim-agent
claude plugin install cst-sim-agent@cst-sim-agent

Reinicia Claude Code después de la instalación y confirma que el plugin está cargado con /plugins; entonces las herramientas cst_* directamente se pueden llamar en la conversación.

La raíz del plugin incluye su propio .claude-plugin/marketplace.json — es en sí mismo un marketplace (source=./). Un marketplace de tipo directory se carga en su lugar, sin dispersion.

Mecanismo de hooks (accionado bajo demanda)

El plugin declara 4 hooks en hooks/; solo inyectan recordatorios cuando algunas herramientas cst_* se llaman realmente en una sesión:

Todos los hooks solo recuerdan, nunca bloquean (no devuelven ningún permissionDecision).

Autoevolución: Er la más usas, más inteligente se vuelve

La base es de conocimentos integrada tanto la materia inicial como el contenedor de la acumulación:

• Uso: el agente realiza el modelado, la resolución y el análisis de resultados en cada simulación;

• Consolidación: al cerrar sesiones, el hook stop_check empuja a que los errores y las conclusiones validadas de la sesión se escriban en references/ (listas de comprobación de errores, biblioteca de sintaxis VBA, manual de experiencia);

• Reutilización: la próxima vez que surja un problema similar, los hooks pre_vba / post_vba guían que consultes antes la biblioteca, en lugar de reincidir en el mismo error.

Esto forma un bucle autoevolutivo de "uso → consolidar → reutilizar" — el plugin acumula experiencia de dominio a medida que se usa, y las tareas que son semejantes funcionan cada vez más fluidamente. La base de conocimientos se aprecia bajo tu control (skills/cst-expert/references/) — lo que consolidad y se conserva es decisión totalmente tuya.

Base de conocimientos de la skill

Incluida con el plugin en skills/cst-expert/references/:

• vba-rules.md — cuatro reducir los hierros, convenciones de comentarios de código, resolución de problemas de MCP

• official-docs.md — mapa de documentación oficial y técnicas de consulta

• case-study-flow.md — flujo de trabajo-profundo de ejemplos oficiales

• common-pitfalls.md — lista general de verificación de errores (puertos / malla / resolvedor / API)

• best-practices-template.md — plantilla en blanco de experiencia incremental (para tus propias aportes)

• knowledge/ — biblioteca de sintaxis VBA (8 dominios), índice de 158 ejemplos oficiales, 35 análisis en profundidad, manual de experiencia

Estructura de directorios

cst-sim-agent/
├── .claude-plugin/plugin.json   # plugin manifest
├── .mcp.json                    # MCP server definition (cst-sim)
├── src/                         # MCP server implementation
│   ├── server.py                # tool registration (FastMCP)
│   ├── controller.py            # unified controller (facade)
│   ├── connection.py            # CST process/project lifecycle
│   ├── dezip.py                 # CST DE-ZIP container parser
│   ├── popup_utils.py           # popup detect/dismiss
│   ├── popup_watchdog.py        # popup watchdog
│   └── version_manager.py       # checkpoint versioning
├── hooks/                       # constraint mechanization hooks
├── skills/cst-expert/           # domain-knowledge skill
└── requirements.txt

Preguntas frecuentes

• cst_connect falla / las herramientas no aparecen: revisa la inmediato de registro de MCP del Claude CLI (Server stderr dentro de %LOCALAPPDATA%\claude-cli-nodejs\Cache\<\workdir-encoded>\mcp-logs-*.jsonl); no supongas.

• Herramienta informa que no encuentra CST: confirma que CST_INSTALL_DIR es apunta a la ruta correcta o que CST está instalado.

• No se puede abrir .cst: .cst es un contenedor DE-ZIP propietario de CST; zipfile de Python no me puede abrirlo — usa src/dezip.py.

• Los resultados del SBR son todos ceros: comprueba primero la geometría material — la geometría importada desde STEP se asigna por defecto un material transparente al dispersión; asigna PEC/dialétic para esperar resultados.

Cómo contribour

Reletamos la validación y las mejoras de la comunidad: abre un informe de fallos, envía código, aporta experiencias a la base de conocimiento. Las convenciones de desarrollo y envío están en CONTRIBUTING; el comportamiento de la comunidad se rige por el CODE_OF_CONDUCT; la comunicación de vulnerabilidades de seguridad parece en SECURITY. El historial de versiones está en CHANGELOG.

Licencia

License Apache 2.0