内容
# CST Studio Orchestrator MCP
一款开源的模型上下文协议（MCP）服务器，能够将CST Studio Suite转化为一个统一的、可由AI控制的仿真环境。
该项目使CST Studio Suite暴露于AI代理和自动化客户端之下。它支持3D电磁建模、天线和射频工作流程、求解器设置、结果提取、PCB/SI助手，以及通过`project.schematic`进行直接CST Design Studio原理图控制，以实现场路联合仿真。
## 亮点
- 177种MCP工具，用于CST自动化的建模、天线、材料、端口、网格、求解器、仿真、结果、PCB/SI、优化、VBA和原理图工作流程。
- 在Windows上使用CST Python库的连接模式，用于实时控制CST Studio Suite。
- 离线模式，用于在CST不可用时生成CST VBA脚本。
- 设计工作室原理图工具，用于RLC组件、外部端口、网络连接、原理图检查、对象发现和通用RemoteObject调用。
- 通用原理图桥，用于CST的运行时`project.schematic`接口，包括`Block`、`Net`、`ExternalPort`、`CircuitProbe`、`SchematicLayout`、`SimulationTask`、`ParameterSweep`和`Optimizer`等对象。
- 内置CST VBA参考数据和原始VBA执行的防护措施。
## 为什么存在
大多数CST自动化示例都关注3D Microwave Studio历史命令。CST Design Studio和原理图工作流程则不太为人所知，因为原理图操作不会可靠地出现在3D历史列表中。
这个分支为Design Studio添加了一个实用的桥梁：
```python
project.schematic.Block
project.schematic.Net
project.schematic.ExternalPort
project.schematic.SchematicLayout
```
在CST Studio Suite 2025.2上，通用原理图工具可以枚举125个`project.schematic`成员，并直接在运行时远程对象上调用方法。
## 原理图工具
专用工具：
- `cst_schematic_create_rlc` 创建一个电阻、电感或电容。
- `cst_schematic_create_external_port` 创建一个原理图外部端口。
- `cst_schematic_connect` 将块或端口的引脚连接到一个命名的网络中。
- `cst_schematic_list` 列出原理图块和网络。
通用桥梁工具：
- `cst_schematic_list_objects` 列出由`project.schematic`公开的成员。
- `cst_schematic_object_methods` 列出某个原理图对象的方法。
- `cst_schematic_call` 调用`project.schematic.<object_name>.<method_name>(*args, **kwargs)`。
示例通用调用：
```json
{
"object_name": "Block",
"method_name": "GetNumberOfPorts",
"args": []
}
```
## 安装
```bash
git clone https://github.com/guardianer9-debug/cst-studio-orchestrator-mcp.git
cd cst-studio-orchestrator-mcp
pip install -e ".[dev]"
```
## MCP 配置
```json
{
"mcpServers": {
"cst-studio-orchestrator": {
"command": "cst-studio-orchestrator-mcp",
"env": {
"CST_PATH": "D:\\CST2025",
"CST_WORK_DIR": "D:\\cst_projects",
"PYTHONPATH": "D:\\CST2025\\AMD64\\python_cst_libraries"
}
}
}
}
```
旧命令名称`mcp-cst-studio`和`cst-field-circuit-mcp`也保留以供兼容使用。
## 连接模式
连接模式要求：
- Windows
- 已安装CST Studio Suite
- CST Python库可在`PYTHONPATH`上使用
- Python 3.10+
示例：
```powershell
$env:PYTHONPATH="D:\CST2025\AMD64\python_cst_libraries;$env:PYTHONPATH"
python -c "import cst.interface; print('CST available')"
cst-studio-orchestrator-mcp
```
## 离线模式
当CST不可用时，大多数建模工具会返回VBA脚本，可以在CST Studio Suite中手动运行。通用原理图反射工具需要连接模式，因为它们依赖于CST运行时远程对象。
## 开发
```bash
pip install -e ".[dev]"
pytest -q
ruff check src tests
```
当前本地验证：
```text
535 passed
ruff: All checks passed
```
## 项目血统
该项目源自`RFingAdam/mcp-cst-studio`，并保留原始的AGPL-3.0-or-later许可证。该分支添加了CST Design Studio原理图自动化和通用`project.schematic` RemoteObject桥，用于更广泛的CST Studio Suite编排，包括天线、RF/EM工作流程、PCB/SI和场路联合仿真。
参见[NOTICE](NOTICE)了解归属详情。
## 许可证
AGPL-3.0-or-later。CST Studio Suite本身是Dassault Systemes/SIMULIA的独立商业产品，不被该项目捆绑或重新分发。
