AlphaCAM MCP Bridge
AI-driven CAM automation server that wraps AlphaCAM 2016 R1 COM API into MCP tools, enabling geometry creation, machining operations, tool management, nesting, and NC code output.
README
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功能合集.bas |
VBA 插件模块(依边界裁剪、全排版刀具偏移、排版刀具排序) |
frmToolOffset.txt |
刀具偏移对话框的窗体定义(VBA UserForm) |
frmToolSort.txt |
刀具排序对话框的窗体定义(VBA UserForm) |
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 工具清单(37 个)
状态与信息(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 插件功能
VBA 插件功能
CCC功能合集.bas 包含三个工具(通过 AlphaCAM 菜单栏 "CCC功能" 访问):
- 依边界裁剪 — 选择边界和线段,将线段超出边界的部分裁剪
- 全排版刀具偏移 — 按刀具名称选择,整体偏移 X/Y/Z
- 排版刀具排序 — 按加工方式+刀具分组,拖拽调整加工顺序
项目链接
- GitHub: https://github.com/cczzyy-cn/AlphacamMCP
- 问题反馈: https://github.com/cczzyy-cn/AlphacamMCP/issues
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.