MCP_CREO_MechDog
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP_CREO_MechDog 0.35.5
当前正式版 0.35.5(PATCH——BUG-144 修复打包单测跨轮次污染:tools/test_unit.py 运行前原子写 build/unit_test_run.json 并绑定本轮 run_id/源码指纹,release_integrity 自本版起要求状态与报告共同支撑“全量通过”声明,tools/package.py 新增 --source-root/--unit-report 并把门禁移到任何产物之前;DEV-099 让 README 工具数引用 creo_capabilities.tool_count;BUG-142 以默认关闭的断开延迟钩子在本机 Creo 10 实机核验被中断的 disconnect 仍保留 unknown_outcome 与预发布事实。公开工具仍 110。承接 0.35.4;未验:其他 Creo 版本、外部反馈环境与 WorkBuddy 黑盒) · 版本说明 · Releases
让 AI 客户端通过 MCP,直接在 Creo Parametric 里创建原生可编辑的参数化特征——不是导出网格,也不是脚本模拟。
MCP_CREO_MechDog 是运行在你自己 Windows 电脑上的本地 MCP 服务(stdio)。它把 Creo 官方 C/C++ Toolkit 封装成 110 个公开工具(以 creo_capabilities 的 tool_count 为准;creo_surface_boundary_fill 已定义但门禁隐藏),供 WorkBuddy、Claude Desktop、Cursor 等支持 MCP 的 AI 客户端调用:从一句需求出发,生成带草图、尺寸、约束与特征树的 .prt / .asm,并保存到磁盘。
适合:重复性参数化建模、批量零件、AI 驱动的草图→拉伸→孔→装配流程、接管已有模型继续修改。 不适合:任意复杂自由曲面、专业模块的完整封装、没有真实 Creo 与许可的「云端建模」。
特性
原生参数化:Creo 内可编辑的草图、拉伸、旋转、孔、圆角、抽壳、钣金、装配,保留尺寸与依赖关系。
公开工具清单(数量以
creo_capabilities返回的tool_count为准;creo_surface_boundary_fill已定义但门禁隐藏,不计入):实体特征、装配、工程图、放样/翼型、曲面修剪/投影曲线/法向偏置、两截面直纹曲面放样、quilt 合并、曲面边圆角、曲面组级缝合测量、数值曲率/G1 分析(不提供斑马纹/曲率梳图像)、参数与关系式、特征树查询、标准螺纹孔、只读质量属性、离线产品变体规划、作业取消(不承诺几何回滚)、保存与导出。保存即校验:每次修改后保存
.prt.N/.asm.N、从磁盘重载并比对特征、尺寸、体积与参数(saved_file_reloaded_and_verified)。可回滚:revision 保护、失败自动回滚、
unknown_outcome保留现场,旧请求不会改坏模型。本地可控:几何计算全在 Creo 进程内完成;服务不执行任意命令、不改动 Creo 安装目录、不上传模型。
Related MCP server: SolidWorks MCP
环境要求
项目 | 要求 |
系统 | Windows x64 |
Python | 3.12+ x64 |
CAD | Creo Parametric 9 / 10 / 12,及匹配的 Toolkit SDK |
构建 | MSVC x64 C++ 构建工具 |
许可 | 可用的 PTC 许可 |
Creo 软件、SDK、模板与许可需自行取得;MIT 只覆盖本项目原创代码、文档与种子库。当前开发与发布按本机 Creo 12.4.0.0 的改动范围验收,Creo 9/10 的已测与未测范围见兼容矩阵。
安装
下载源码,解压到较短的可写目录(如
C:\MCP_CREO_MechDog),在该目录执行后续命令。运行安装脚本,换成自己的 Creo 安装根目录:
.\setup.ps1 -CreoRoot 'C:\Program Files\PTC\Creo 12.4.0.0'脚本会创建
.venv/、编译 Toolkit 执行器、生成config.json与client-config.json。Python 不在 PATH 时可加-Python '...\python.exe',编译器未自动找到时可加-VcVars64 '...\vcvars64.bat'。把
client-config.json中的服务配置加入支持本地 stdio MCP 的 AI 客户端并启动。
完整步骤与排错见 docs/INSTALL.md。升级后先重启 MCP 连接器,再核对路径、启动指纹与工具清单。
快速开始
客户端配置(路径以安装生成的为准;本机开发联调按约定使用 MCP_CREO_MechDog_dev):
{
"mcpServers": {
"MCP_CREO_MechDog": {
"command": "C:\\MCP_CREO_MechDog\\.venv\\Scripts\\python.exe",
"args": ["C:\\MCP_CREO_MechDog\\server.py"]
}
}
}服务启动后,让 AI 调用 creo_startup_status 等 state == "ready"、creo_session_status 确认连接,再调用 creo_execute_plan,例如创建 Ø20×30 的圆柱:
{
"operations": [
{"op":"sketch","label":"profile","plane":"XY",
"entities":[{"type":"circle","name":"circle","center":[0,0],"radius":10}],
"dimensions":[{"name":"diameter","type":"diameter","refs":[{"entity":"circle"}],"value":20,"position":[15,0]}]},
{"op":"extrude","label":"solid","sketch":"profile","depth":30}
],
"assertions":{"require_solid":true,"volume_mm3":9424.77796076938}
}建模工具立即返回 job_id;轮询 creo_get_job(job_id, detail="compact") 到 status == "succeeded",确认 result.saved_file_reloaded_and_verified == true。随后调用 creo_set_sketch_dimensions(model_id=返回的模型ID, expected_revision=最新revision, sketch="profile", values={"diameter":24}),拉伸实体随之更新。
两个约定:修改已有模型要传最新
expected_revision;Toolkit 单通道忙碌时立即返回status="busy"(不排队、不自动重试),已接受的任务只轮询、不重新提交。
长度单位为毫米、角度为度;引用格式见引用格式,更多可复制方案见 examples/。
功能一览
类别 | 代表工具 |
零件与计划 |
|
草图与实体 |
|
修饰与基准 |
|
钣金 |
|
装配 |
|
放样与翼型 |
|
曲面与实体化 |
|
参数化修改 |
|
查询与导出 |
|
完整清单以 creo_capabilities 为准;各类能力的验收范围与边界见兼容矩阵与语法参考。
文档
我想… | 看这里 |
安装、排错、升级 | |
查工具参数与引用格式 | |
找可复制的建模方案 | |
确认哪些功能已实测 | |
种子库 / 换电脑换 Agent | |
直接混合的一次性回调 | |
查看版本变更 | |
参与开发 / 看台账 |
已知限制
不是所有参数组合与几何都已实机验证;无效轮廓、基准或特征顺序由 Creo 返回错误,AI 需自行规划。
Creo 9 编译探测修复已实现,但本机无 Creo 9 SDK,实机编译与建模运行时未验收;Creo 10 不再要求独立复测。
钣金四壁、relief 去料、嵌套装配、面级上色等仍有明确边界;直接混合(
creo_loft)需一次性回调注册,种子放样不需要。串行单通道,无队列、FIFO 或容量保证;未测与开放项按统一台账跟进。
不提供任意命令/代码执行,不输出许可服务器内容;正在交互建模或有模态对话框时应先处理该会话状态。
开发
开发维护从开发入口与统一功能台账开始,每项工作先定义验收。常用命令:
.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe tools\dev_check.py
.\.venv\Scripts\python.exe tools\test_general.pyGit仅用于补充commit/branch/dirty,不是MCP服务、原生编译或离线单测的必需条件。源码ZIP没有.git或PATH中没有Git时,证据工具使用分发目录源码SHA256,Git身份明确为null;目录哈希不代表Git提交。creo_check_environment.development_tools.git_available只作开发提示,不影响ready_to_build。
全量单测依机器和夹具耗时而变,已有实测约6–18分钟;用build/unit_test_report.json的duration_seconds、skipped和skipped_tests核对本次耗时与跳过项。较慢机器可执行python tools/dev_check.py --unit-timeout-seconds 1800。移除Git时请保留PowerShell等系统工具;不要把精简PATH造成的命令缺失当作产品故障。离线重建editable包需提前缓存pyproject.toml指定的构建wheel,使用PIP_NO_INDEX=1和PIP_FIND_LINKS指向本地wheel目录;本项目不要求单测时下载依赖。
tools/test_general.py 等集成测试会真实连接 Creo 并创建测试模型;语言/单元检查与 Creo 实机验收分别记录证据。
许可证
MIT。第三方依赖与 PTC 前置条件见 THIRD_PARTY_NOTICES.md;Creo 软件、SDK、模板与许可不包含在本项目中,需自行取得。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
A browser 3D CAD for your AI: it scripts real-size models, uCAD builds them and returns pictures.
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to build and edit native CAD parts and assemblies, inspect saved geometry and measurements, retain revisions, run mechanism and interference checks, and export STEP/STL/GLB artifacts through MCP tools.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents on Windows to build parts from JSON recipes, create and verify whole assemblies in a single call, check mass, center of mass, mates and interference, produce drawings with BOM, balloons and sections, work with sheet metal, and import/export STEP, IGES, PDF and DXF files. All edits run with automatic backups and verified rollback so user files are never left broken.2MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to drive CAD workflows through 87 tools for documents, part studios, sketching, solid features, assemblies, drawings, measurement, rendering, and export. It supports zero-config browser sign-in and secure credential storage.87156 npmMIT
- AlicenseBqualityCmaintenanceEnables AI agents to create and modify parts and assemblies in a running Creo Parametric 5 session through MCP, including feature modeling, dimension and parameter edits, model queries, exports, and screenshots for visual verification.28MIT