Mathcad MCP

🚀 Mathcad MCP Server

A Model Context Protocol (MCP) server that integrates with PTC Mathcad Prime, enabling AI assistants like Claude to interact with Mathcad worksheets through a standardized interface.

🚀 Quick Start

This server allows AI assistants such as Claude to interact with Mathcad worksheets via a standardized interface, facilitating seamless operations in a variety of mathematical computing scenarios.

✨ Features

• Worksheet Management: Open, close, and save Mathcad worksheets.
• Input Control: Set numerical values, strings, and matrices (with units).
• Output Access: Retrieve calculation results and their units.
• Calculation Management: Pause, resume, and recalculate worksheets.
• Export Options: Save worksheets as PDF, RTF, and XPS files.

📦 Installation

Quick Installation with Claude Desktop

1. Install the required dependencies:

pip install -r requirements.txt

2. Run the installation script:

python install_standalone.py

Options:

• Use the --hide flag to hide the Mathcad window: python install_standalone.py --hide

3. Restart Claude Desktop for the changes to take effect.

Manual Configuration

Edit your Claude Desktop configuration file located at ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mathcad": {
    "visible": true,
    "path": "C:\\Program Files\\PTC\\Mathcad Prime 3.0"
  }
}

📚 Documentation

Requirements

• Windows operating system (required for Mathcad COM automation).
• Python 3.10 or higher.
• PTC Mathcad Prime 3.0 or higher installed.
• Dependencies: MathcadPy, pywin32, and MCP Python SDK (see requirements.txt).

Environment Variables

• MATHCAD_VISIBLE: Set to "true" to display the Mathcad application window (default), or "false" to hide it.

Architecture

The server is built using the FastMCP framework of the MCP Python SDK. The main components include:

• standalone.py: A self - contained server script with Mathcad integration.
• install_standalone.py: A utility script for installing the server in Claude Desktop.

Troubleshooting

Common Issues

COM Automation Errors

When encountering COM automation errors:

• Ensure that Mathcad is installed and properly licensed.
• Check that you are running on Windows.
• Try restarting Mathcad and the MCP server.

Worksheet Not Found

If the worksheet is not found:

• Use absolute paths instead of relative paths.
• Ensure that the file path is correctly escaped.
• Verify that the file exists and is a valid .mcdx file.

Unit Conversion Issues

If unit conversion fails:

• Check the compatibility between units (e.g., length cannot be converted to mass).
• Ensure that the correct unit symbols are used (e.g., 'm' for meters).
• Try using standard unit formats (e.g., 'm/s' instead of 'm*s^(-1)').

📄 License

This project is under the MIT license. See the LICENSE file for details.

👏 Acknowledgments

• MathcadPy - A Python wrapper for the Mathcad Prime automation API.
• Model Context Protocol - Protocol specification and SDK.