AlphaCAM Bridge

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

概述

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

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

文件说明

文件	说明
server.py	MCP 桥接器主程序（Python），通过 STDIO/SSE 协议与 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 工具清单（52 个）

状态与信息（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	创建文字标注

几何查询（1）

工具	说明
get_all_geometries	列出全部几何的完整信息（类型、范围、属性）

查询列表（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	创建或获取图层（可设颜色）

视图控制（5）

工具	说明
view_zoom_extents	缩放全图适应屏幕
view_zoom_window	框选窗口缩放
view_set_direction	设置 3D 视角方向（俯视/前视/等轴测等）
lock_acam	禁用屏幕刷新（批量操作时加速）
unlock_acam	恢复屏幕刷新（可选缩放全图）

材料（1）

工具	说明
get_material	获取当前图纸材料信息（名称、密度、进给、转速等）

路径操作（5）

工具	说明
mirror_path	沿直线镜像路径（几何/刀具路径）
offset_path	偏置封闭路径（左/右侧，指定距离）
copy_temporary_store	复制路径为临时几何，可镜像后存储
get_path_attributes	读取路径的用户属性
set_path_attribute	设置路径的用户属性

排版信息（3）

工具	说明
has_nesting	检查当前图纸是否包含排版信息
get_nesting_info	获取排版详情（Sheet、零件、实例数据）
get_sheet_extents	获取全部排版 Sheet 的全局范围

操作排序（2）

工具	说明
order_operations_all	按排版 Sheet 顺序自动排序所有刀具路径
order_manual	手动指定顺序重排几何/刀具路径

VBA 与插件（4）

工具	说明
run_vba_macro	运行 VBA 宏（支持传参）
load_addin	加载插件 DLL / VBA 项目
enable_addin	启用/禁用插件
list_addins	列出已加载的全部插件

后处理器（1）

工具	说明
select_post	选择后处理器

API 文档（3）

工具	说明
list_docs	列出文档来源目录及文件分类数量
read_doc	读取指定文档页（API 参考、3D/4D 用户手册等）
search_docs	按关键词搜索全部文档（自动检测 AlphaCAM 安装目录）

文档搜索自动检测 AlphaCAM 安装目录，覆盖 tempacamapi（VBA API）、ACAM3（3D 模块）、ACAM4（4 轴模块）等所有已提取的 HTML 文档。未安装 AlphaCAM 时可放置 *_html 文件夹在 chm/ 目录下作为离线回退。

文档转换（1）

工具	说明
chm_to_html	将 .chm 编译帮助文件转换为 HTML 文件

实用工具（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