Skip to content
Tresca

PyMechanical-MCP

MCP serverOfficial · Pre-1.0

Ansys's own MCP server for Mechanical: launches or attaches to a session over gRPC, runs scripts, solves and exports results. By Ansys (Synopsys).

37 starsUpdated 2 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 a local or remote Ansys Mechanical install with a gRPC endpoint; docs examples use 2026 R1, v261)
Operating systems
Windows, macOS, Linux
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

  • Exposes 28 tools in seven groups, from launching or connecting to Mechanical through file transfer, scripting and solving to screenshots and log retrieval.
  • Launches Mechanical in GUI or batch mode, or connects to a session already started with gRPC enabled, locally, remotely or in a container.
  • Finds objects in the model tree, describes their API, and previews a property change before applying it.
  • Keeps a persistent Python session for PyMechanical code, and returns built-in guidance for common Mechanical workflow steps.

Limitations

  • Version 0.3.x and marked Alpha on PyPI; v0.3.0 already renamed one tool, so client prompts may need updating between releases.
  • Needs Python 3.12 to 3.14, plus uv and Git for the uvx route.
  • The HTTP transport is meant for trusted networks or behind a proxy that adds authentication and TLS.

Install

claude mcp add --transport stdio pymechanical-mcp -- \
  uvx --index-strategy unsafe-best-match \
  --from git+https://github.com/ansys/pymechanical-mcp \
  ansys-mechanical-mcp

Source: mechanical-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.