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

<p align="center">

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

<b>Video 1: PyMAPDL MCP Demo</b>

</p>

<video controls width="720" src="_static/videos/PyMAPDL-MCP-demo.mp4"> Your browser does not support the video tag. </video>

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

• PyMAPDL-MCP documentation
• PyMAPDL Documentation
• Model Context Protocol
• FastMCP Documentation
• Ansys MAPDL
• Repository's Issues page
• Repository's Discussions page

For general PyAnsys questions, email [email protected].