iflow-mcp_hvkshetry-mathcad-mcp 0.1.0
A Model Context Protocol (MCP) server for PTC MathCAD Prime integration
Requires Python: >=3.10

# MathCAD MCP Server

A Model Context Protocol (MCP) server that provides integration with PTC MathCAD Prime, allowing AI assistants like Claude to interact with MathCAD worksheets through a standardized interface.

## Features

- **Worksheet Management**: Open, close, and save MathCAD worksheets
- **Input Control**: Set numerical values, strings, and matrices with units
- **Output Access**: Retrieve calculation results with proper units
- **Calculation Management**: Pause, resume, and recalculate worksheets
- **Export Options**: Save worksheets as PDF, RTF, and XPS files

## 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)

## 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 `--hide` flag to hide the MathCAD window when running: `python install_standalone.py --hide`

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

### Manual Configuration

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

```json
{
  "mcpServers": {
    "mathcad": {
      "command": "python",
      "args": [
        "path/to/mathcad-mcp/standalone.py"
      ],
      "env": {
        "MATHCAD_VISIBLE": "true"
      }
    }
  }
}
```

## Usage

### Tools

The server exposes the following MCP tools:

- `list_mathcad_version`: Get the running MathCAD version
- `open_worksheet`: Open a MathCAD worksheet from a file path
- `close_worksheet`: Close a specific worksheet
- `close_all_worksheets`: Close all open worksheets
- `quit_mathcad`: Quit the MathCAD application entirely
- `save_worksheet`: Save a worksheet to a specified path and format
- `save_worksheet_inplace`: Save the worksheet in place
- `activate_worksheet`: Bring a worksheet to the front
- `set_real_input`: Set a numerical input with optional units
- `set_string_input`: Set a string input
- `set_matrix_input`: Set a matrix input with optional units
- `get_input`: Retrieve the current value of a designated input (real/string/matrix)
- `get_matrix_input`: Retrieve the current value of a designated matrix input
- `calculate_worksheet`: Recalculate a worksheet
- `sync_worksheet`: Alias for calculating the worksheet
- `pause_calculation`: Pause worksheet calculation
- `resume_calculation`: Resume worksheet calculation
- `get_output`: Get a designated output value (real, string, or matrix)
- `get_real_output`: Get a numerical output value from a worksheet
- `get_real_output_with_units`: Get a numerical output value with conversion to specified units
- `get_matrix_output`: Get a matrix output from a worksheet
- `get_matrix_output_with_units`: Get a matrix output with unit conversion
- `save_as_pdf`: Save the worksheet as a PDF file (Mathcad Prime 5+ only)
- `save_as_rtf`: Save the worksheet as an RTF file
- `save_as_xps`: Save the worksheet as an XPS file
- `is_worksheet_readonly`: Check if a worksheet is read-only
- `is_worksheet_modified`: Check if a worksheet has unsaved changes
- `set_worksheet_modified`: Force-set the 'modified' status of a worksheet

### Resources

The server exposes the following MCP resources:

- `mathcad://worksheets`: List all open worksheets
- `mathcad://worksheets/paths`: List worksheets with full file paths
- `mathcad://worksheet/{worksheet_name}/inputs`: List inputs in a worksheet
- `mathcad://worksheet/{worksheet_name}/outputs`: List outputs in a worksheet
- `mathcad://worksheet/{worksheet_name}/output/{output_name}`: Get a specific output value
- `mathcad://worksheet/{worksheet_name}/output/{output_name}/matrix`: Get a matrix output
- `mathcad://worksheet/{worksheet_name}/output/{output_name}/with_units/{units}`: Get an output with units conversion
- `mathcad://worksheet/{worksheet_name}/info`: Get information about a worksheet
- `mathcad://worksheet/{worksheet_name}/status`: Get the status of a worksheet

### Prompt Templates

The server provides the following prompt templates to assist in MathCAD-related tasks:

- `solve_equation`: Template for solving mathematical equations
- `plot_function`: Template for plotting functions
- `analyze_engineering_problem`: Template for analyzing engineering problems
- `unit_conversion`: Template for unit conversion tasks
- `create_worksheet_template`: Template for creating new worksheet templates

## Example Workflows

### Example 1: Solving a Physics Problem

```
1. Open an existing MathCAD worksheet:
   "Can you open my physics worksheet at C:\Users\username\Documents\Physics\projectile_motion.mcdx?"

2. Set input parameters:
   "Set the initial velocity to 50 m/s and the launch angle to 30 degrees."

3. Calculate the results:
   "Now calculate the trajectory and show me the maximum height and distance."

4. Extract output values:
   "What's the maximum height reached by the projectile?"
```

### Example 2: Engineering Analysis

```
1. Open or create a worksheet for analysis:
   "I need to analyze a beam deflection problem. Can you open the structural_analysis.mcdx worksheet?"

2. Configure the worksheet:
   "Set the load P to 5000 N, beam length L to 2 m, Young's modulus E to 200 GPa, and moment of inertia I to 4×10⁻⁶ m⁴."

3. Run the calculation:
   "Calculate the worksheet and tell me the maximum deflection."

4. Export the results:
   "Save the worksheet as a PDF so I can include it in my report."
```

## Environment Variables

- `MATHCAD_VISIBLE`: Set to "true" to show the MathCAD application window (default), or "false" to hide it.

## Architecture

The server is built using the MCP Python SDK's FastMCP framework. The main components are:

- `standalone.py`: Self-contained server script with MathCAD integration
- `install_standalone.py`: Utility script to install the server in Claude Desktop

## Troubleshooting

### Common Issues

#### COM Automation Errors

If you encounter COM automation errors:
- Ensure MathCAD is installed and properly licensed
- Check that you're running on Windows
- Try restarting MathCAD and the MCP server

#### Worksheet Not Found

If worksheets can't be found:
- Use absolute paths, not relative paths
- Ensure file paths are correctly escaped
- Verify the file exists and is a valid `.mcdx` file

#### Unit Conversion Issues

If unit conversion fails:
- Check for compatibility between units (e.g., length can't convert to mass)
- Ensure that the right 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 licensed under the MIT License - see the LICENSE file for details.

## Acknowledgments

- [MathcadPy](https://github.com/MattWoodhead/MathcadPy) - Python wrapper for the MathCAD Prime automation API
- [Model Context Protocol](https://modelcontextprotocol.io) - Protocol specification and SDK