ansys/pyaedt-mcp

PyAEDT-MCP 是 Ansys Electronics Desktop（AEDT）的 MCP（模型上下文协议）服务器。它为你提供可靠的 AEDT 工具和持久的 PyAEDT 支持的 Python 会话，用于那些不适合专用工具的任务。

PyAEDT-MCP的工作

PyAEDT-MCP 支持以下运行时循环：

1. 检查AEDT是否已安装或已可访问。
2. 启动AEDT，或连接到已有的gRPC会话。
3. 打开项目，创建设计，运行分析，检查模型并导出结果。
4. 使用run_python_code或run_python_script进行自定义PyAEDT。

支持的AEDT应用包括HFSS、Maxwell 2D/3D、Q2D、Q3D、Icepak、Circuit、TwinBuilder、Mechanical、EMIT、RMXprt和HFSS 3D布局。

安装

不克隆就跑

安装uv，然后 先git。git是必须的，因为uvx 直接从该仓库下载并运行 PyAEDT-MCP，无需克隆。 推荐使用 Python 3.13;--python 3.13 显式选择并允许 uv 如果需要，可以下载。

本地安装

使用Python 3.13或更高版本的环境（推荐3.13）。

或者使用uv：

Windows 安装程序

Windows 版本包括 PyAEDT-MCP-Installer-windows.exe：

PyAEDT-MCP is an MCP (Model Context Protocol) server for Ansys Electronics Desktop (AEDT). It gives you reliable AEDT tools and a persistent PyAEDT-backed Python session for tasks that do not fit a dedicated tool.

What PyAEDT-MCP does

PyAEDT-MCP supports this runtime loop:

1. Check whether AEDT is installed or already reachable.
2. Launch AEDT or connect to an existing gRPC session.
3. Open projects, create designs, run analyses, inspect the model, and export results.
4. Use run_python_code or run_python_script for custom PyAEDT work.

Supported AEDT applications include HFSS, Maxwell 2D/3D, Q2D, Q3D, Icepak, Circuit, TwinBuilder, Mechanical, EMIT, RMXprt, and HFSS 3D Layout.

Install

Run without cloning

Install uv and Git first. Git is required because uvx downloads and runs PyAEDT-MCP directly from this repository without cloning it. Python 3.13 is recommended; --python 3.13 selects it explicitly and lets uv download it if needed.

uvx --python 3.13 --from git+https://github.com/ansys/pyaedt-mcp.git ansys-aedt-mcp

Install locally

Use a Python 3.13 or later environment (3.13 recommended).

pip install git+https://github.com/ansys/pyaedt-mcp.git

Or use uv:

uv pip install git+https://github.com/ansys/pyaedt-mcp.git

Windows installer

Windows releases include PyAEDT-MCP-Installer-windows.exe:

• Installs the desktop manager into C:\Program Files\ANSYS Inc\PyAEDT MCP.