内容
# Ansys Maxwell MCP 服务器
[](https://github.com/Jairam-1/ansys-maxwell-pyaedt-mcp/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.python.org/downloads/)
一个开源的[模型上下文协议](https://modelcontextprotocol.io/)（MCP）服务器，允许 AI 助手驱动 **Ansys Maxwell** 电磁仿真通过 [PyAEDT](https://aedt.docs.pyansys.com/)。
与任何 MCP 兼容的客户端配合使用 — Claude Code、Claude Desktop、Cursor 或任何其他兼容工具。
> **免责声明：** 这是一个独立的、个人开源项目。它 **不隶属于、未得到、也未获得 ANSYS, Inc.** 的认可或赞助。“Ansys”、“Maxwell” 和 “AEDT” 是 ANSYS, Inc. 的商标。本项目是一个 API 包装器，需要您提供自己的许可 Ansys 安装；它不包含、分发或绕过任何 Ansys 软件或许可。
## 功能
| 层 | 功能 |
|-------|-----------|
| **工具** | 启动/关闭 Maxwell，绘制几何（立方体、圆柱体、多边形线），分配材料，设置边界（矢量势、主从），创建线圈和绕组激励，配置 EddyCurrent/Transient/Magnetostatic 设置，运行仿真，提取力，导出场图，读写设计变量 |
| **资源** | 用于 SLIM/DSLIM 线性感应电机建模的领域知识 — 已知的故障模式、验证的工作流程和完整的设计向量 |
| **提示** | `dslim_troubleshooter` 用于脚本审查以防止已知陷阱；`maxwell_setup_guide` 用于逐步仿真设置 |
## 先决条件
1. **Python 3.10+**
2. **Ansys Electronics Desktop (AEDT)** 已在本地安装 — MCP 服务器调用 PyAEDT，通过 COM 驱动 AEDT。
3. **有效的 Ansys 许可证** — 本项目是一个 API 包装器；它不包含或绕过任何 Ansys 软件。
## 安装
```bash
git clone https://github.com/Jairam-1/ansys-maxwell-pyaedt-mcp.git
cd ansys-maxwell-pyaedt-mcp
pip install -e .
```
或使用 [uv](https://docs.astral.sh/uv/)：
```bash
uv pip install -e .
```
## 配置
将服务器添加到您的 AI 客户端的 MCP 配置中。
### Claude Code / Claude Desktop
添加到您的 `claude_desktop_config.json` 或 `~/.claude.json` 中：
```json
{
"mcpServers": {
"ansys-maxwell": {
"command": "python",
"args": ["-m", "ansys_maxwell_pyaedt_mcp.server"]
}
}
}
```
### Cursor
在您的项目中添加到 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"ansys-maxwell": {
"command": "python",
"args": ["-m", "ansys_maxwell_pyaedt_mcp.server"]
}
}
}
```
## 快速开始
配置完成后，询问您的 AI 助手：
> “启动 Maxwell 3D，创建一个铜盒，设置一个静磁仿真并解决它。”
或用于线性机器工作：
> “阅读 DSLIM 最佳实践并帮助我设置一个 4 极线性感应电机的 3-D 周期性涡流仿真。”
## 工具参考
### 会话管理
- `launch_maxwell` — 启动 AEDT 并初始化 Maxwell 2-D 或 3-D 会话
- `close_maxwell` — 优雅地释放桌面 COM 句柄
- `set_solution_type` — 在 EddyCurrent、Transient、Magnetostatic 等之间切换
- `set_model_depth` — 为 2-D 设计设置平面外 ModelDepth（毫米）
### 几何
- `create_box` — 绘制一个 3-D 立方体并分配材料
- `create_cylinder` — 沿任意轴绘制圆柱体
- `create_polyline` — 从顶点绘制多边形线
### 材料
- `assign_material` — 从 Ansys 库应用材料
- `list_materials` — 列出可用材料
### 边界
- `assign_vector_potential` — 应用 A = const 边界
- `assign_master_slave` — 应用周期性主从对
### 激励
- `assign_coil` — 分配具有匝数和极性的线圈激励
- `assign_winding` — 将线圈分组为电流或电压绕组
### 仿真
- `assign_force` — 在求解前将力参数分配给对象
- `setup_eddy_current` — 配置 EddyCurrent 求解
- `setup_transient` — 配置 Transient 求解
- `setup_magnetostatic` — 配置 Magnetostatic 求解
- `analyze` — 运行仿真（阻塞；门控 `setup.is_solved`)
### 后处理
- `get_forces` — 从已求解的设置中提取 Fx、Fy、Fz 以获取已分配的力
- `export_field_plot` — 将场叠加导出为图像
- `get_design_variable` / `set_design_variable` — 读取/写入参数变量
## DSLIM 资源
此服务器包括来自双侧线性感应电机研究的特定领域资源：
- **`dslim://best-practices`** — Maxwell 中线性感应电机的建模经验：定子馈电极性、60°绕组带、极数记账、gRPC 边界条件、2-D ModelDepth、`is_solved` 求解门控、Russell-Norsworthy 边缘修正、瞬态脆弱性和验证的 3-D 周期工作流程。
## 开发
```bash
git clone https://github.com/Jairam-1/ansys-maxwell-pyaedt-mcp.git
cd ansys-maxwell-pyaedt-mcp
pip install -e ".[dev]"
ruff check . # lint
pytest # 测试套件（PyAEDT 已存根，因此不需要 Ansys 安装）
```
CI 在每次推送和拉取请求上运行 lint、Python 3.10-3.12 上的测试套件和软件包构建
（`.github/workflows/ci.yml`）。推送 `v*` 标签
构建 sdist/wheel 并将其附加到 GitHub Release
（`.github/workflows/release.yml`）。
## 贡献
欢迎贡献。请先打开一个问题来讨论您想更改的内容。
## 免责声明
本项目是一个独立的、个人的开源努力，**不隶属于、未得到、也未获得 ANSYS, Inc.** 的认可或赞助。“Ansys”、“Maxwell”和“AEDT”是其各自所有者（ANSYS, Inc.）的商标，仅在此用于描述互操作性。软件按“原样”提供，不提供任何类型的保证（参见 [LICENSE](LICENSE)）。您负责持有有效的 Ansys 许可证来使用底层 Ansys Electronics Desktop；本项目不包含或绕过任何 Ansys 软件或许可机制。
## 许可证
[MIT](LICENSE)
