Skip to content
Tresca

PyMAPDL MCP Server

MCP serverOfficial · Pre-1.0

Ansys's own MCP server for Mechanical APDL: runs APDL commands and PyMAPDL code in a live MAPDL session and plots results. By Ansys (Synopsys).

12 starsUpdated 3 days agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
Ansys Mechanical / MAPDL
How it connects
Drives a running copy of the tool
Access
Can modify models
Tool versions
unknown (needs an Ansys MAPDL installation, local, remote or in Docker)
Operating systems
Not stated in its documentation
Needs a Ansys Mechanical / MAPDL licence
Yes
Transport
Local (stdio), Remote (HTTP)
AI clients documented
Claude Code, Claude Desktop, VS Code (GitHub Copilot)
Licence
Apache-2.0
Language
Python
Release status
pre 1 0

What it can do

  • Launches a new MAPDL instance, connects to an existing one, or disconnects on request.
  • Runs single APDL commands or batches of them, plus free-form Python and PyMAPDL code in a persistent session.
  • Produces matplotlib and PyVista plots or captures MAPDL's own plots.
  • Returns guidance for each phase of a MAPDL analysis, from preprocessing to postprocessing.

Limitations

  • Version 0.3.x and marked Alpha on PyPI.
  • The HTTP transport has no authentication; the docs warn that anyone who can reach the port can run arbitrary Python and APDL /SYS commands, so keep it on loopback.
  • Needs Python 3.12 or later.

Install

claude mcp add --transport stdio pymapdl -- uvx --from git+https://github.com/ansys/pymapdl-mcp ansys-mapdl-mcp

Source: mapdl-mcp.docs.pyansys.com/version/stable/getting_started/ide_configuration.html

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.