PyMAPDL MCP Server

PyMAPDL MCP Server provides a Model Context Protocol (MCP) server that enables AI assistants to interact with Ansys MAPDL (Mechanical APDL) through PyMAPDL. This server enables natural language interaction with MAPDL for finite element analysis tasks.

Overview

Key features:

Dynamic connection management: Launch new MAPDL instances, connect to existing ones, or disconnect on demand
Execute MAPDL commands: Run single commands or batch multiple commands for efficiency
Custom Python execution: Run arbitrary Python and PyMAPDL code in a persistent session
Advanced visualization: Create custom matplotlib and pyvista plots, or capture MAPDL native plots
Workflow guidance: Access comprehensive context and best practices for all phases of MAPDL simulations
Flexible deployment: Works with MAPDL running locally, remotely, or in Docker containers

https://github.com/user-attachments/assets/99b68fbd-2308-46a0-aa44-9684ae7400b7

Video 1: PyMAPDL MCP Demo

Your browser does not support the video tag.

Installation

For users

Install the latest release with:

pip install ansys-mapdl-mcp

Or run directly without installing using uvx:

uvx --from git+https://github.com/ansys/pymapdl-mcp ansys-mapdl-mcp

For developers

git clone https://github.com/ansys/pymapdl-mcp.git
cd pymapdl-mcp
pip install -e .[tests]

Usage

For step-by-step setup instructions for VS Code, Claude Code, Claude Desktop, and other MCP-compatible clients, see the IDE and Client Configuration page in the documentation.

License

This project is licensed under the Apache 2.0 license agreement. See the LICENSE file for details.

Resources

For general PyAnsys questions, email pyansys.core@ansys.com.

Metadata

Release files for ansys-mapdl-mcp 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ansys-mapdl-mcp 0.3.0
File	Size	Uploaded
ansys_mapdl_mcp-0.3.0.tar.gz	38.8 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ansys-mapdl-mcp 0.3.0
File	Interpreter	ABI	Platform	Reset
ansys_mapdl_mcp-0.3.0-py3-none-any.whl 42.9 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 81.8 kB

Release files / ansys_mapdl_mcp-0.3.0.tar.gz

Download URL	ansys_mapdl_mcp-0.3.0.tar.gz
Size	38.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`f8ca649d62e8767fc26005a4496a0b9204273d065d90258d1ae535ebb26d2994`
BLAKE2b-256 checksum How to use checksums	`1f4e9c0568eeb27da8b6af0c17104c254d8a860886f5f00936b73c604c05eaf0`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ansys/pymapdl-mcp
Publishing commit: github.com/ansys/pymapdl-mcp/tree/4d1be926d8f0a01a5663dfe74bed8402feaeb34a

Workflow

Publishing configuration: github.com/ansys/pymapdl-mcp/blob/4d1be926d8f0a01a5663dfe74bed8402feaeb34a/.github/workflows/ci.yml
Publishing logs: github.com/ansys/pymapdl-mcp/actions/runs/35380150719/attempts/1

Artifact

Subject: ansys_mapdl_mcp-0.3.0.tar.gz
SHA-256 checksum: f8ca649d62e8767fc26005a4496a0b9204273d065d90258d1ae535ebb26d2994 Verifying attestations

Release files / ansys_mapdl_mcp-0.3.0-py3-none-any.whl

Download URL	ansys_mapdl_mcp-0.3.0-py3-none-any.whl
Size	42.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b7933716c7bfb62cea53a5a2fb43e92a0a5e519f4c2d6e38456f0535ce08ca39`
BLAKE2b-256 checksum How to use checksums	`093931a4be641a7013f2a12d0e86c6cc755626c423e61b9d5503aa1f39bf86c3`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ansys/pymapdl-mcp
Publishing commit: github.com/ansys/pymapdl-mcp/tree/4d1be926d8f0a01a5663dfe74bed8402feaeb34a

Workflow

Publishing configuration: github.com/ansys/pymapdl-mcp/blob/4d1be926d8f0a01a5663dfe74bed8402feaeb34a/.github/workflows/ci.yml
Publishing logs: github.com/ansys/pymapdl-mcp/actions/runs/35380150719/attempts/1

Artifact

Subject: ansys_mapdl_mcp-0.3.0-py3-none-any.whl
SHA-256 checksum: b7933716c7bfb62cea53a5a2fb43e92a0a5e519f4c2d6e38456f0535ce08ca39 Verifying attestations