
MathCAD MCP Server

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)
-
安装所需的依赖项:
pip install -r requirements.txt
-
运行安装脚本:
python install_standalone.py
选项:
- 使用 --hide
标志在运行时隐藏 MathCAD 窗口:python install_standalone.py --hide
- 重新启动 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 服务器是否正确启动
- 验证工作表路径是否正确
- 检查输入/输出名称是否与工作表中的定义匹配