机械行业知识与技术交流平台 JXB / INDUSTRIAL SYSTEM

【连接器】PowerMill 2021 MCP 连接器:让 AI 直接驱动软件数控编程

为什么做这个

数控编程这件事,最费时间的往往不是想工艺,而是在软件里反复点:建毛坯、设坐标系、挑刀具、改余量、算刀路、等计算、再一条条塞进 NC 程序、后处理出代码。这些动作有明确的规则,却只能靠人手一步步点。

PowerMill 2021 没有官方 API,只留了一个 DoCommandEx 的命令通道。所以我们做了这个 MCP 连接器:把 PowerMill 2021 包装成 WorkBuddy 可以直接调用的 32 个工具,让"检查这批刀路的余量是否一致""按这个基准重新算一遍""把这四条刀路按顺序出成 NC"变成一句话的事。

PowerMill 2021 MCP 连接器


它长什么样

连接器是一个本地 MCP 服务(stdio,不开端口),服务端只做四件事:校验参数、检查权限、串行下发命令、回读结果。你的 AI 助手通过标准 MCP 协议调用它,它再把每一条命令翻译成 PowerMill 真实能执行的宏。

从 WorkBuddy 到 PowerMill 的命令链路

和"直接调 COM 接口"的脚本相比,它有三个不一样的地方:

  • 不把"命令返回了"当成成功。 每条命令执行后回读状态:刀路条目有没有真的插进去、顺序对不对、NC 文件有没有真的落盘。对不上就报错,而不是回你一句"已完成"。

  • 卡住的时候说清卡在哪。 PowerMill 弹模态框、命令窗口停在续行提示、没选后处理器,这三种情况都会让命令静默失败。连接器能识别它们,并给出可执行的下一步,而不是让你对着超时发呆。

  • 高风险动作要过两道门。 计算、写入、后处理这类动作首次调用不执行,先返回一次性确认令牌,参数完全一致才放行。所有调用写审计日志,令牌不进日志。


32 个工具,覆盖到出代码

32 个工具的八个能力方向

权限分五级,可以只开到你放心的那一档:

权限能做典型工具
read只看健康判定、实体列表、任务状态
operate建对象、切激活导入模型、设毛坯、建刀具、建刀路
compute算计算刀路、碰撞检查
write改与出改参数、组装 NC、后处理
admin救场关对话框、复位续行、执行自定义宏

真机跑过,不是纸上谈兵

下面这张图是一次真实加工准备的结果:方形毛坯、D12 立铣刀、区域清除刀路,刀轨在模型上方分层排开。

PowerMill 2021 中的区域清除刀路

从导入模型到出 NC,这条链是在装了 PowerMill 2021 的机器上跑完的:

  • 生成 .tap 共 5781 行,刀路顺序 FACE → ROUGH → FINISH → PROFILE,换刀 3 次,程序预估 12 分 23 秒

  • 回归测试 63 项全通过,其中 35 条来自真机事故复盘(宏语法、模态框、续行态、NC 顺序错乱……每一条都对得上一次真实故障)

  • 真机自检脚本 8 项全绿:连接探针、失败可见、坏命令后会话仍健康、NC 写出

说清楚边界:碰撞判读、过切结论和 NC 内容正确性仍需人工确认后才能上机。连接器负责把命令正确、可追溯地执行到位,不替工艺员签字。


自行安装:三步

第一步,确认环境:Windows + PowerMill 2021(已在 2021.0.00.64 上验证)+ Python 3.10 以上。PowerMill 与 WorkBuddy 必须同一 Windows 用户、同一权限级别运行,否则 COM 会看不见对方。

第二步,解压后装依赖并自检:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[windows,dev]"

rem 先跑不需要 PowerMill 的部分
.\.venv\Scripts\python.exe -m pytest
.\.venv\Scripts\python.exe scripts\mcp_smoke.py

rem PowerMill 已启动后,跑真机自检
.\.venv\Scripts\python.exe scripts\selfcheck.py

第三步,在 WorkBuddy 的 MCP 配置里登记服务(默认只附加已运行的实例,不会自己启动软件):

{
  "mcpServers": {
    "MCP_PowerMill2021": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["-m", "powermill_mcp"],
      "env": {
        "POWERMILL_MCP_ADAPTER": "com",
        "POWERMILL_MCP_PERMISSIONS": "read,operate,compute",
        "POWERMILL_MCP_STATE_DIR": "C:\\pm-mcp-state"
      }
    }
  }
}

保存后到连接器管理页的自定义连接器入口点「信任」,刷新会话即可。建议先用 read,operate,compute 跑一轮,确认刀路和 NC 都对,再决定要不要开 write。

自动安装:安装包上传WorkBuddy,该页面网址同时上传,让其自动按上述流程配置安装,完成后只需在 自定义连接器入口点「信任」该MCP


下载

下载 PowerMill 2021 MCP 连接器

包里含 MCP 服务端源码、32 个工具的完整参数说明、环境变量示例、事故复盘文档和回归测试。解压后按上面三步接入;遇到问题先看 docs/DIAGNOSIS.md,里面记了每个坑的现场现象和根因。


已知限制(先说清楚)

  • PowerMill 2021 无法用命令设置坐标系原点:建坐标系后连接器会回读真实原点并告诉你是否偏移,不匹配时不假装成功。精确放置请在界面里做。

  • NC 程序的条目不能可靠删除,所以同名程序会直接报错让你换名字,而不是覆盖出一个顺序错乱的程序。

  • 多开 PowerMill 时 COM 绑定不保证选中指定窗口,需要指定实例要走 .NET 插件桥接。

  • 宏路径必须是纯 ASCII;中文内容写宏默认拒绝。

这些限制都写在 docs/LIMITATIONS.md 里,附了官方来源和替代方案。


最后

做这个连接器的过程,本质上是把"老师傅点鼠标的那套动作"翻译成机器能验证的步骤。翻译得准不准,不看跑通一次,而看失败的时候它说不说实话——所以我们把大半精力花在了判活、回读和错误上报上。

欢迎拿真实零件试,尤其是我们没覆盖到的策略和机床后处理。遇到报错,把 details 里的命令和反馈贴出来,那基本就是问题所在。

DISCUSSION

技术交流 0

理性讨论 · 分享经验 · 共同进步
暂时还没有评论,欢迎分享您的专业见解。

参与技术交流

取消回复

验证码,点击刷新

请遵守社区规范,勿发布无关信息。