ANSYS HFSS MCP Server

⚠️ Note: This repository contains an architectural demo. The complete proprietary algorithms (including parametric geometry generation, Pozar equations, and port alignment) are hidden in this public version. However, the core MCP protocol handling, state management, and async job scheduling architecture are fully functional. A Model Context Protocol (MCP) server that enables AI assistants to interact with ANSYS HFSS through natural language commands, powered by PyAEDT over gRPC.

Design antennas, assign boundaries, run simulations, and retrieve results — all by chatting with Claude.

Compatible Clients

Related MCP server: hfss-agent-native

Capabilities

Connection Management

Geometry

Materials

Excitations

Solution Setup

Solve & Results

Antenna Design Workflows

Scripting

Requirements

• ANSYS Electronics Desktop (AEDT) 2023 R1 or later with HFSS

• Python 3.10+

• PyAEDT (ansys-aedt-core or pyaedt)

Installation

git clone https://github.com/scutdeng/mcp-server.git
cd mcp-server
python -m venv venv
venv\Scripts\activate       # Windows
pip install .

Configuration

Find your client's config file and add the mcp-server server entry:

Add this block:

{
  "mcpServers": {
    "mcp-server": {
      "command": "C:/path/to/mcp-server/venv/Scripts/python.exe",
      "args": ["C:/path/to/mcp-server/hfss_mcp_server.py"],
      "env": {
        "ANSYSEM_ROOT261": "C:/Program Files/ANSYS Inc/v261/AnsysEM"
      }
    }
  }
}

Replace v261 with your installed AEDT version (e.g. v232, v241, v251).

Usage

1. Start HFSS and get the gRPC port

Open ANSYS Electronics Desktop. In the Message Manager, look for:

gRPC server started on port 50051

2. Connect Claude to HFSS

In your chat with Claude:

"Connect to HFSS on port 50051"

3. Design an antenna

"Design a 2.4 GHz patch antenna"

Claude will:

• Create a new Modal Network design with all parameters as HFSS variables

• Build geometry: Substrate, Airbox, Ground plane, Patch, Coax probe, Teflon dielectric

• Assign boundaries: PerfE (ground & patch), coax shield, radiation boundary

• Add a wave port with integration line

• Create Setup1 (adaptive mesh) + frequency sweeps

• Insert a 3D far-field sphere

• Solve and generate S11, E-plane, H-plane, and 3D gain reports

"Design a 438 MHz dipole antenna"

Claude will build a center-fed half-wave dipole in free space with a Terminal Network solution, lumped port, and full radiation analysis.

4. Poll for results (long jobs)

Long workflows run in the background. Claude will give you a job_id and poll automatically:

"Get script result for job_1"

Antenna Design Parameters (Patch — 2.4 GHz, mirrors HFSSDesign22)

All parameters are created as HFSS design variables, and every geometry object is built from variable expressions (not baked floats), so the model is fully parametric — matching the "Type: Design" properties you'd see in the HFSS Properties panel — and you can sweep them:

License

Apache 2.0 — see LICENSE