cst-sim-agent

Китайская версия

Плагин для Claude Code, который через MCP превращает CST Studio Suite в разговорного ассистента по электромагнитному моделированию.

AI for Science (AI4S) переводит ИИ из «разговоров» в «реальные исследования и инженерную работу».

Для электромагнитного моделирования настоящее узкое место вот в чём: агенту нужно работать с профессиональным ПО вроде CST, но оно не может плавно с ним общаться — даже после успешного подключения он не знает правильных имён методов VBA и адаптированных к CST идиом Python. Универсальные LLM никогда не обучались работе с CST; сырой код рождает выдуманные фантомные методы, а одна ошибка (10091) может стоить нескольких часов.

cst-sim-agent решает эту задачу трёхуровневой архитектурой: набор MCP-инструментов позволяет естественному языку вести цепочку «моделирование → назначение материалов → настройка портов → расчёт → чтение результатов»; встроенная доменная база знаний (библиотека VBA-синтаксиса по 8 областям, 158 официальных примеров, чек‑листы типичных ошибок) позволяет агенту подсматривать и сразу применять — без перечитывания технической документации, повторного изучения настроек интерфейса и даже физики при смене прикладной области, как пришлось бы инженеру-человеку; проверочные хуки сверяются с библиотекой перед написанием VBA и с окном сообщений CST после выполнения — защита от галлюцинаций и «тихих» сбоев. На сквозной приёмочной проверке этот механизм выполнил за два дня около 20 проектов моделирования разными методами (построение, смена методов, параметрическое сравнение), а тот же объём вручную занял бы недели. Главное — механизм саморазвивается вместе с использованием: каждая встреченная ошибка и каждый подтверждённый опыт в конце сеанса возвращаются в базу знаний, замыкая петлю «использование → закрепление → повторное применение»: чем больше вы используете, тем он умнее и тем плавнее проходят похожие задачи.

Наша цель — принести AI for Science на рабочие места инженеров и исследователей моделирования — не заменить инженеров, а расширить человеческую способность вести науку через физическое моделирование: оставить агенту повторяющиеся механические операции и изучение смежных областей, а за человеком сохранить электромагнитное проектирование и физическое суждение, освободив инженеров.

Возможности

Related MCP server: CST Studio Orchestrator MCP

Зрелость и верификация

Этот плагин вырос из нескольких инженерных проектов автоматизации CST, прошёл внутреннее итерационное развитие и перед первым публичным релизом — независимую слепую приёмочную проверку. Подтверждённое покрытие: установка и хуки, подключение к реальному инстенации CST, сквозной официальный учебный пример патч-антенны, сверка базы знаний и остаточных замечаний. Пока не полностью покрыто репозитории: совместимость с несколькими версиями CST, более сложные модели и больше комбинаций инструментов — должны проверяться сообществом вместе.

Сквозной официальный пример (круговая патч-антенна, 2–3 ГГц) доведён до результата: резонанс S11 на 2.40 ГГц, что совпадает с опорным значением официального руководства CST (≈2.4 ГГц). См. отчёт о верификации.

Выбор технологий и архитектурные решения (основной канал — VBA, вспомогательный — официальный API) задокументированы в документе об архитектуре.

Предварительные требования

• Windows (COM-интерфейс CST живёт на Windows)

• CST Studio Suite 2024/2025/2026 (2026-ого рекомендуется; старее версии скорее всего в большей мере работать работают, но но не проверялись по-отдельности)

• Python 3.10+ (в том числе лаунчер py Windows — идёт в официальный инсталлятор Python; MCP-сервер запускается через py -3 и не зависит от python в PATH)

• Зависимости Python: pip install -r requirements.txt (mcp, pywin32)

Определение пути официальной библиотеккилова Python-библиотеки CST (src/controller.py, src/connection.py):

1. Сначала читается переменная окружения CST_INSTALL_DIR (корень установки CST, например C:\Program Files\CSTStudio Suite 2026)

2. Иначе автоматически определяются типовые места установки (C:\Program Files\CST Studio Suite 202x и т.п.)

Установить переменную окружения CST_INSTALL_DIR рекомендуется надёжности ради пути.

Wait - no need. Sorry.

Let's output the final output cleanly, including the GXP placeholders.# cst-sim-agent

Китайская версия

Плагин для Claude Code, который через MCP превращает CST Studio Suite в диалогового ассистента электромагнитного моделирования.

AI for Science (AI4S) переводит ИИ из «разговоров» в «реальные исследования и инженерную работу».

В электромагнитном моделировании реальное узкое место выглядит так: агенту нужно работать с профессиональным ПО вроде CST, но он не может с ним гладко взаимодействовать — даже после успешного подключения он не знает правильных имён методов VBA или адаптированных к CST идиом Python. Универсальные LLM никогда не обучались работать в CST; написанный с нуля код рождает выдуманные фантомные методы, а одна ошибка (10091) может стоить часов.

cst-sim-agent решает это трёхуровневый схемой: слой MCP-инструментов позволяет естественному языку управлять цепочкой «моделирование → назначение материалов → настройка портов → расчёт → чтение результатов»; встроенная экспертная база знаний (библиотека VBA-синтаксиса по 8 доменам, 158 официальных примеров, чек-листы типичных ошибок) позволяет агенту посмотреть первый и сразу применить — без перечитывания технической документации, повторного изучения настроек интерфейса и даже переизучения физики при смене прикладной области усиления человеку-инженеру; проверочные хуки проверяют библиотеку перед написанием VBA и окно сообщений CST после выполнения — защищают от галлюцинаций и «тихих» сбоев. В сквозном приёмочном тесте этот механизм за 2 дня завершил около 20 проектов моделирования с разными методами (построение, смена методов, параметрическое сравнение); тот же результат полностью предоставленный вручную потребовал бы целой неделя. Более важно то, что механизм саморазвивается вместе с вами: каждая найденная ошибка и каждый подтверждённый результат в конце сеанса записываются в базу знаний, формируя цикл «применение → закрепление → повторное использование»: чем больше используете, тем работа умнее, тем плавнее аналогичные задачи в следующий раз.

Наше видение — принести AI for Science на рабочие столы инженеров и исследователей: заменить повторяющиеся механические операции и кросс-доменное исследование агенту, сохранить за людьми электромагнитное проектирование и физическое суждение, и тем самым дать инженерам больше свободы.

Возможности

Зрелость и верификация

Плагин вырос из нескольких проектов автоматизации CST, прошёл несколько внутренних итераций и прошёл независимый слепой приёмочный тест перед первым публичным выпуском. Проверенный охват: установка и хуки, подключение к фактическому приложению CST, официальное учебное описание патч-антенны от начала до конца, сверка знаний и остаточный ревью. Частично непокрыт пока: совместимость с несколькими поверхностями CST, более сложные модели и другие комбинации инструментов, потребуется помощь сообщества программ разработчиков.

В сквозном официальном примере (круглая патч-антенна, 2–3 ГГц) резонанс S11 на уровне 2.40 ГГц, что совпадает с контрольным значением (≈2.4 ГГц) из официального руководства CST. См. отчёт о верификации

Технологические решения и проектные решения (основной — канал VBA, дополнительный — официальный API) описаны в документе по архитектуре.

Предварительные требования

• Windows (COM-интерфейс CST живёт на Windows)

• CST Studio Suite 2024/2025/2026 (реком.2026; более старые версии должны работать, но отдельно не проверялись)

• Python 3.10+ (включая лаунчер Windows py — поставляется с официальным инсталлятором Python; MCP-сервер стартует через py -3 и не зависит от наличия python в PATH)

• Зависимости Python: pip install -r requirements.txt (mcp, pywin32)

Механизмбазовый раестразивассы очень. устранить.

Опередим курсов CST официальной Python-библиотеки (src/controller.py, src/connection.py):

1. Сначала читаем переменную среды CST_INSTALL_DIR (её следует задать как корень установки CST, напр. C:\Program Files\CST Studio Suite 2026)

2. Иначе автоматически ищем типичные каталоги установки (C:\Program Files\CST Studio Suite 202x и др.)

Для гарантированного резрешения пути рекомендуем выставить переменную среды CST_INSTALL_DIR.

Установка

# 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

Перезапустите Claude Code после установки и подтвердите в /plugins, что плагин загружен; после этого инструменты cst_* будут зваться прямо в разговоре.

Корень плагина поставляется со своим .claude-plugin/marketplace.json — это самостоятельный маркетплейс (source=./). Маркетплейсы status directory подключаются без действия копирования….

Механизм хуков (добавляется по требованию)

Плагин объявляет 4 хука в hooks/; они уведомляют о необходимости проверки только когда в сессии реально вызываются инструменты cst_*:

Хуxxa только напоминают, никогда не блокируют (они не возвращают permissionDecision).

Самоэволюция: чем больше используете — тем умнее становится

Встроенная база знаний является одновременно начальными знаниями и накопителем:

• Использование: агент выполняет моделирование, расчёт и как результат — анализ в каждом симуляционном проекте;

• Закрепление: при завершении сеанса хук stop_check заставляет напомнить о необходимости зафиксировать собранные ошибки и подтверждённые выводы в references/ (чек-лист ошибок, библиотека VBA, журнал опыта);

• Повторение: при следующей подобной задаче хуки pre_vba / post_vba ориентируют сначала использовать библиотеку, а не попадать на те же грани конструкции.

В целом создается полный сумма формования цикла «использование → закрепление → повторение», плагин накапливает прикладное знание, и похожие задачи движутся всё плавнее. База знаний полностью под вашим контролем (skills/cst-expert/references/) — что закреплять и что хранить попадает исключительно по вашему усмотрению.

Skill — база знаний

Входит в плагин в виде каталога skills/cst-expert/references/:

• vba-rules.md — четыре ждлиных железных правила, договорённости о столе комментариев, решение проблем MCP;

• official-docs.md — карта официальной документации и приёмы поиска;

• case-study-flow.md — умный процесс освоения официальных примеров;

• common-pitfalls.md — общий перечень типовых ошибок (порты, сетка, солвер, ловушки API);

• best-practices-template.md — пуст blank шкаблон свежого опыта (для собственных записей);

• knowledge/ — библиотека VBA-синтаксиса (8 областей), 158 официальных примеров, 35 глубоких разборов, журнал опыта.

Структура каталогов

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

FAQ

• cst_connect падает / инструменты не появляются: сначала посмотрите журнал MCP Claude CLI (Server stderr внутри %LOCALAPPDATA%\claude-cli-nodejs\Cache\<workdir-encoded>\mcp-logs-*.jsonl); не гадайте.

• Инструмент сообщает, что CST не найден: подтвердите, что установлена CST_INSTALL_DIR или CST находится в стандартном расположении.

• .cst не открывается: .cst это частный формат CST, упакованный conteiners DE-ZIP; zipfile Python не может его открыть — используйте src/dezip.py.

• SBR-результаты все нули: сначала проверьте питер — геометрия из STEP по умолчанию имеет материал "водух-прозрачный" (scatter-transparent); задайте PEC/диэлектрик before diperлучить рассеяние.

Contributing вклад

Мы приветствует проверки и улучшения от сообщества: сообщайте issue, submit code, добавляйте базу знаний. Правила разработки и приема описаны в CONTRIBUTING; поведение участников события — в CODE_OF_CONDUCT; сообщения о безопасности — в SECURITY. История версий — в CHANGELOG.

Лицензия

Apache License 2.0