MathCAD MCP Server

MathCAD MCP Server

site icon
2025.03.26 1
Python数学计算工程分析开发效率
MathCAD MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 PTC MathCAD Prime 进行集成,允许 AI 助手(如 Claude)通过标准化接口与 MathCAD 工作表进行交互。该服务提供了工作表管理、输入控制、输出访问、计算管理和导出选项等核心功能,适用于工程分析、物理问题求解等场景。
View on GitHub

Overview

基本能力

产品定位

MathCAD MCP Server 是一个用于与 PTC MathCAD Prime 集成的中间件服务,旨在通过标准化接口实现 AI 助手与数学计算软件的交互。

核心功能

  • 工作表管理:打开、关闭和保存 MathCAD 工作表
  • 输入控制:设置数值、字符串和带单位的矩阵
  • 输出访问:检索计算结果及其单位
  • 计算管理:暂停、恢复和重新计算工作表
  • 导出选项:将工作表保存为 PDF、RTF 和 XPS 文件

适用场景

  • 工程问题分析与计算
  • 物理问题求解
  • 数学方程求解与绘图
  • 单位转换任务
  • 创建工作表模板

工具列表

  • list_mathcad_version: 获取运行的 MathCAD 版本
  • open_worksheet: 从文件路径打开 MathCAD 工作表
  • close_worksheet: 关闭特定工作表
  • close_all_worksheets: 关闭所有打开的工作表
  • quit_mathcad: 完全退出 MathCAD 应用程序
  • save_worksheet: 将工作表保存到指定路径和格式
  • save_worksheet_inplace: 原地保存工作表
  • activate_worksheet: 将工作表置于前台
  • set_real_input: 设置带可选单位的数值输入
  • set_string_input: 设置字符串输入
  • set_matrix_input: 设置带可选单位的矩阵输入
  • get_input: 检索指定输入(实数/字符串/矩阵)的当前值
  • get_matrix_input: 检索指定矩阵输入的当前值
  • calculate_worksheet: 重新计算工作表
  • sync_worksheet: 计算工作表的别名
  • pause_calculation: 暂停工作表计算
  • resume_calculation: 恢复工作表计算
  • get_output: 获取指定输出值(实数、字符串或矩阵)
  • get_real_output: 从工作表中获取数值输出值
  • get_real_output_with_units: 获取带单位转换的数值输出值
  • get_matrix_output: 从工作表中获取矩阵输出
  • get_matrix_output_with_units: 获取带单位转换的矩阵输出
  • save_as_pdf: 将工作表保存为 PDF 文件(仅限 Mathcad Prime 5+)
  • save_as_rtf: 将工作表保存为 RTF 文件
  • save_as_xps: 将工作表保存为 XPS 文件
  • is_worksheet_readonly: 检查工作表是否为只读
  • is_worksheet_modified: 检查工作表是否有未保存的更改
  • set_worksheet_modified: 强制设置工作表的'修改'状态

常见问题解答

COM 自动化错误

  • 确保 MathCAD 已安装并正确授权
  • 检查是否在 Windows 上运行
  • 尝试重新启动 MathCAD 和 MCP 服务器

找不到工作表

  • 使用绝对路径,而不是相对路径
  • 确保文件路径正确转义
  • 验证文件是否存在且是有效的 .mcdx 文件

单位转换问题

  • 检查单位之间的兼容性(例如,长度不能转换为质量)
  • 确保使用正确的单位符号(例如,'m' 表示米)
  • 尝试使用标准单位格式(例如,'m/s' 而不是 'm*s^(-1)')

使用教程

使用依赖

  • Windows 操作系统(MathCAD COM 自动化必需)
  • Python 3.10 或更高版本
  • 已安装 PTC MathCAD Prime 3.0 或更高版本
  • 依赖项:MathcadPy、pywin32 和 MCP Python SDK(参见 requirements.txt)

安装教程

快速安装(使用 Claude Desktop)

  1. 安装所需的依赖项: pip install -r requirements.txt

  2. 运行安装脚本: python install_standalone.py

选项: - 使用 --hide 标志在运行时隐藏 MathCAD 窗口:python install_standalone.py --hide

  1. 重新启动 Claude Desktop 以使更改生效。

手动配置

编辑 Claude Desktop 配置文件(Mac:~/Library/Application Support/Claude/claude_desktop_config.json,Windows:%APPDATA%\Claude\claude_desktop_config.json):

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

调试方式

  • 确保 MathCAD 应用程序正常运行
  • 检查 MCP 服务器是否正确启动
  • 验证工作表路径是否正确
  • 检查输入/输出名称是否与工作表中的定义匹配

许可证

该项目遵循 MIT 开源许可条款。