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.2

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.2
File	Size	Uploaded
ansys_mapdl_mcp-0.3.2.tar.gz	38.8 kB	Oct 7, 2026	Details

Built distribution (wheel)

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

Total release size: 81.8 kB

Release files / ansys_mapdl_mcp-0.3.2.tar.gz

Download URL	ansys_mapdl_mcp-0.3.2.tar.gz
Size	38.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`e9499354052805b74eaf21b09064360f3b254f78a2e69766829c67bf32e132e4`
BLAKE2b-256 checksum How to use checksums	`b17945a8513f3dedb599bb11c980fe625a190538f09f8611ae555256025f12af`
Upload date	Oct 7, 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/70379b6d99eb2e963833a3452916d5d37fb734f7

Workflow

Publishing configuration: github.com/ansys/pymapdl-mcp/blob/70379b6d99eb2e963833a3452916d5d37fb734f7/.github/workflows/ci.yml
Publishing logs: github.com/ansys/pymapdl-mcp/actions/runs/37641839240/attempts/2

Artifact

Subject: ansys_mapdl_mcp-0.3.2.tar.gz
SHA-256 checksum: e9499354052805b74eaf21b09064360f3b254f78a2e69766829c67bf32e132e4 Verifying attestations

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

Download URL	ansys_mapdl_mcp-0.3.2-py3-none-any.whl
Size	42.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a9f0b8ba2be32c71783d18a48827afbd9beef3f75764ed9a02515458055dc05d`
BLAKE2b-256 checksum How to use checksums	`80e182c4431e907383d203b50746c477ba0d61725353503b34e5518ca63d30b7`
Upload date	Oct 7, 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/70379b6d99eb2e963833a3452916d5d37fb734f7

Workflow

Publishing configuration: github.com/ansys/pymapdl-mcp/blob/70379b6d99eb2e963833a3452916d5d37fb734f7/.github/workflows/ci.yml
Publishing logs: github.com/ansys/pymapdl-mcp/actions/runs/37641839240/attempts/2

Artifact

Subject: ansys_mapdl_mcp-0.3.2-py3-none-any.whl
SHA-256 checksum: a9f0b8ba2be32c71783d18a48827afbd9beef3f75764ed9a02515458055dc05d Verifying attestations