PyAnsys Common MCP는 PyAnsys 라이브러리를 위한 Model Context Protocol (MCP) 서버를 구축하는 인프라를 제공합니다.

개요

이 패키지는 PyAnsys 라이브러리를 통해 Ansys 제품과 상호 작용하기 위해 AI Assistants(Cleude, ChatGPT)와 같은 MCP 서버를 만드는 기반을 제공합니다.

** 키 기능:**

• **Persistent 파이썬 세션 **: 여러 AI 요청을 통해 stateful code 실행을 유지합니다.
• ** Lifecycle 관리**: 시작, 정리 및 오류를 자동으로 처리합니다.
• **Extensible Architecture **: 기본 클래스와 제품별 구현 패턴을 사용합니다.
• **로깅 인프라 **: MCP 프로토콜과 방해하지 않는 사전 구성 로깅을 사용합니다.

설치

사용자

``ansys.common.mcp] 패키지는 현재 Python 3.12를 지원합니다. Windows, Mac OS 및 Linux에서 Python 3.14.

이 명령을 사용하여 최신 패키지를 설치:

대안으로, 최신 설치 PyAnsys 공통 MCP GitHub 패키지 이 명령으로:

개발자용

PyAnsys Common MCP에 기여하거나 사용자 정의 서버를 만들려면 개발자 모드에서 패키지를 설치하십시오.

빠른 시작

PyAnsys Common MCP

PyAnsys Common MCP provides the infrastructure for building Model Context Protocol (MCP) servers for PyAnsys libraries.

Overview

This package provides the foundation for creating MCP servers that enable AI assistants (like Claude, ChatGPT) to interact with Ansys products through PyAnsys libraries.

Key features:

• Persistent Python sessions: Maintains stateful code execution across multiple AI requests.
• Lifecycle management: Handles startup, cleanup, and errors automatically.
• Extensible architecture: Uses base classes and patterns for product-specific implementations.
• Logging infrastructure: Uses pre-configured logging that does not interfere with the MCP protocol.

Installation

For users

The ansys.common.mcp package currently supports Python 3.12 through Python 3.14 on Windows, Mac OS, and Linux.

Install the latest package for use with this command:

pip install ansys-common-mcp

Alternatively, install the latest PyAnsys Common MCP GitHub package with this command:

pip install git+https://github.com/ansys/pyansys-common-mcp.git

For developers

If you are contributing to PyAnsys Common MCP or creating custom servers, install the package in developer mode:

# Clone the repository
git clone https://github.com/ansys/pyansys-common-mcp.git
cd pyansys-common-mcp

# Install in editable mode with development dependencies
pip install -e .[dev]

# Or install documentation dependencies for building documentation
pip install -e .[doc]

Quick start

To create an MCP server for your PyAnsys library, follow these three main steps:

1. Define your custom context: Extend the PyAnsysBaseAppContext dataclass to store the product-specific state.
2. Implement your MCP server: Extend the PyAnsysBaseMCP base class with startup and cleanup logic.
3. Create MCP tools: Define tools that interact with your product.

Real-world example

For a complete, production-ready implementation, see the PyMAPDL-MCP repository.

Resources