AlphaCAM MCP 桥接器 — AI 驱动的 CAM 自动化

通过 Model Context Protocol (MCP) 让 AI 助手直接操作 AlphaCAM 2016 R1。

概述

本桥接器将 AlphaCAM 2016 R1 的 COM API 封装为 MCP 工具，使 AI 能够实时：

创建/读取/修改几何图形（线、圆、矩形、多边形、椭圆）
执行加工操作（粗精加工、轮廓铣槽、雕刻、钻孔等）
管理刀具和刀具路径
处理排版嵌套（Nesting）
运行 VBA 宏
输出 NC 代码

文件说明

| 文件 | 说明 | |---|---| | server.py | MCP 桥接器主程序（Python），通过 STDIO 协议与 AI 通信 | | alphacam_com.py | AlphaCAM COM 自动化封装层 | | CCC功能/ | VBA 插件合集目录（依边界裁剪、全排版刀具偏移、排版刀具排序） | | RevNest_source/ | RevNest 反向排版 v1.2 插件完整源码（从 AlphaCAM 提取） | | install.bat | Windows 一键安装脚本 | | install_vba.py | VBA 代码安装到 AlphaCAM 的 Python 脚本 | | make_icons.py | 生成工具栏 BMP 图标的工具 | | SKILL.md | MCP 技能定义 | | requirements.txt | Python 依赖 |

安装

前提条件

Windows 7+ / 10 / 11
AlphaCAM 2016 R1 已安装
Python 3.10+（需要 pywin32 和 mcp 库）

快速安装

# 安装 Python 依赖
pip install -r requirements.txt

# 双击运行 install.bat，或手动注册到 AI 客户端的 MCP 配置

手动配置

在 AI 客户端的 MCP 配置文件中添加：

{
  "mcpServers": {
    "alphacam-bridge": {
      "command": "python",
      "args": [
        "C:\path\to\server.py",
        "--progid",
        "aroutaps.Application"
      ]
    }
  }
}

MCP 工具清单（49 个）

状态与信息（2）

| 工具 | 说明 | |---|---| | get_status | 检查 AlphaCAM 连接状态、版本、路径 | | get_drawing_info | 获取当前图纸详情（几何数、路径数、图层、操作数） |

文件操作（7）

| 工具 | 说明 | |---|---| | new_drawing | 新建空白图纸 | | open_drawing | 打开 .amd 文件 | | open_dxf | 打开 DXF/DWG 文件 | | open_step | 打开 STEP 文件 | | open_stl | 打开 STL 文件 | | save_drawing | 保存图纸（可另存为） | | output_nc | 输出 NC 代码到文件 |

几何创建（6）

| 工具 | 说明 | |---|---| | create_rectangle | 创建矩形（指定两角点） | | create_circle | 创建圆（指定直径和圆心） | | create_line | 创建直线（指定两端点） | | create_polygon | 创建正多边形（指定边数/半径） | | create_ellipse | 创建椭圆（指定长/短轴） | | create_text | 创建文字标注 |

查询列表（3）

| 工具 | 说明 | |---|---| | list_geometries | 列出所有几何图形 | | list_operations | 列出所有操作 | | list_toolpaths | 列出所有刀具路径 |

删除（2）

| 工具 | 说明 | |---|---| | delete_selected | 删除选中的几何 | | delete_all_geometries | 删除全部几何（保留刀具路径） |

裁剪（1）

| 工具 | 说明 | |---|---| | trim_with_boundary | 以边界裁剪线段 |

加工操作（1）

| 工具 | 说明 | |---|---| | run_machining | 执行加工（粗精加工、轮廓铣槽、雕刻、钻孔、啄钻、攻丝、镗孔），完整控制进给/转速/深度 |

刀具（2）

| 工具 | 说明 | |---|---| | select_tool | 从库中选择刀具 | | get_current_tool | 获取当前刀具信息 |

工作平面与图层（3）

| 工具 | 说明 | |---|---| | create_workplane | 创建工作平面 | | set_workplane | 设置当前工作平面 | | create_layer | 创建或获取图层（可设颜色） |

VBA 与插件（3）

| 工具 | 说明 | |---|---| | run_vba_macro | 运行 VBA 宏（支持传参） | | load_addin | 加载插件 DLL / VBA 项目 | | enable_addin | 启用/禁用插件 |

后处理器（1）

| 工具 | 说明 | |---|---| | select_post | 选择后处理器 |

API 文档（3）

| 工具 | 说明 | |---|---| | list_docs | 列出 API 文档分类及文件数 | | read_doc | 读取指定 API 文档页 | | search_docs | 搜索 API 文档 |

实用工具（3）

| 工具 | 说明 | |---|---| | set_undo_point | 设置撤销点 | | zoom_all | 缩放全图 | | run_workflow | 批量执行多步骤工作流 |

VBA 插件功能

CCC功能/ 目录包含四个 VBA 工具（通过 AlphaCAM 菜单栏 "CCC功能" 访问）：

| 文件 | 功能 | |---|---| | Events.bas | 插件入口，注册"CCC功能"菜单 | | modTrim.bas | 依边界裁剪 — 选择边界和线段，将线段超出边界的部分裁剪 | | modOffset.bas | 全排版刀具偏移 — 按刀具名称选择，整体偏移 X/Y/Z | | modSort.bas | 排版刀具排序 — 按加工方式+刀具分组，拖拽调整加工顺序 | | modMirror.bas | 反面镜像 — 自动镜像排版 Sheet 几何生成反面（X 轴或 Y 轴镜像） | | frmToolOffset.txt / frmToolSort.txt | 刀具偏移/排序对话框的窗体定义 |

RevNest 反向排版

RevNest_source/ 目录包含从 AlphaCAM 2016 R1 ReverseNest.arb 插件提取的完整源码，实现排版零件的反面镜像生成。详见 RevNest_API参考.md。

项目链接

GitHub: https://github.com/cczzyy-cn/AlphacamMCP
问题反馈: https://github.com/cczzyy-cn/AlphacamMCP/issues

AlphaCAM MCP Bridge