mathcad-mcp

🚀 数学cad MCP 服务器

数学cad MCP服务器提供了与PTC数学cad Prime集成的模型上下文协议（MCP），它允许像Claude这样的AI助手通过标准化接口与数学cad工作表进行交互，极大地提升了工作效率和交互的便利性。

🚀 快速开始

数学cad MCP服务器为AI助手与数学cad工作表的交互提供了标准化接口。若要使用该服务器，需先完成安装与配置。

✨ 主要特性

• 工作表管理：可对数学cad工作表进行打开、关闭和保存操作。
• 输入控制：支持设置数值、字符串和矩阵（带单位）。
• 输出访问：能够检索计算结果及其单位。
• 计算管理：可暂停、恢复和重新计算工作表。
• 导出选项：可以将工作表另存为PDF、RTF和XPS文件。

📦 安装指南

使用Claude Desktop的快速安装

1. 安装所需的依赖项：

   pip install -r requirements.txt
   

2. 运行安装脚本：

   python install_standalone.py
   

   选项：
   • 使用 --hide 标志以隐藏数学cad窗口：python install_standalone.py --hide
3. 重新启动Claude Desktop，使更改生效。

手动配置

编辑您的Claude Desktop配置文件，该文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

📚 详细文档

环境变量

• MATHCAD_VISIBLE：设置为 "true" 显示数学cad应用程序窗口（默认），或 "false" 隐藏它。

架构

服务器使用MCP Python SDK的FastMCP框架构建。主要组件包括：

• standalone.py：自包含的服务器脚本，带有数学cad集成。
• install_standalone.py：用于在Claude Desktop中安装服务器的实用程序脚本。

故障排除

常见问题

COM自动化错误

遇到COM自动化错误时：

• 确保数学cad已安装并正确许可。
• 检查是否在Windows上运行。
• 尝试重新启动数学cad和MCP服务器。

工作表未找到

如果找不到工作表：

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

单位转换问题

如果单位转换失败：

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

📄 许可证

该项目在MIT许可证下，见LICENSE文件了解详细信息。

致谢

• MathcadPy - Python包装器用于数学cad Prime自动化API。
• 模型上下文协议 - 协议规范和SDK。