CNCjs MCP服务器
MCP服务器将Claude Code桥接到CNCjs,用于GRBL CNC控制(FoxAlien XE Ultra)。
建筑
Claude Code ←stdio/MCP→ cncjs-mcp (Node.js) ←Socket.IO v1→ CNCjs :8000 ←USB Serial→ GRBL工具(共56个)
只读/查询(17)
list_serial_ports, get_connection_status, get_machine_state, get_machine_position, get_work_coordinate_offset, get_machine_settings, get_parser_state, get_loaded_gcode, get_job_progress, get_workflow_state, get_feeder_status, list_macros, list_machines, get_alarm_info, get_console_output, get_error_info, analyze_gcode
连接(2)
connect_to_port, disconnect_port
控制(16)
send_gcode, load_gcode, start_job, pause_job, resume_job, stop_job, home_machine, unlock_machine, jog, set_feed_override, set_spindle_override, set_work_zero, spindle_control, coolant_control, set_wcs, probe_z
安全(3)
emergency_stop (软复位0x18), feed_hold, jog_cancel
管理(1)
run_macro
G代码生成(4)
generate_gcode_profile --切割二维形状(圆形、矩形、自定义路径) generate_gcode_pocket --透明矩形或圆形口袋 generate_gcode_drill --带peck支撑的钻孔模式(网格、圆形、自定义) generate_gcode_facing --表面修整/平整
设计文件生成(2)
generate_svg --创建SVG文件以导入Carveco/Fusion 360 generate_dxf --为CAM软件导入创建DXF R12文件
Fusion 360集成(2)
generate_fusion_script -为Fusion 360生成Python API脚本(绘制、挤出、旋转、圆角、倒角、导出、CAM设置) list_fusion_scripts --列出以前生成的脚本
FreeCAD集成(3)
generate_freecad_model --生成用于无头3D建模的Python脚本(长方体、圆柱体、球体、圆锥体、草图、拉伸、布尔运算、导出STEP/STL) generate_freecad_cam --使用G代码导出生成CAM刀具路径脚本(轮廓、凹穴、钻孔、面操作) list_freecad_scripts --列出以前生成的FreeCAD脚本
Adobe Illustrator集成(3)
generate_illustrator_script --为矢量艺术作品(矩形、圆形、多边形、星形、文本、路径,导出为SVG/DXF/PDF)生成ExtendScript(.jsx) generate_illustrator_export_script --使用文本到大纲选项将当前文档批量导出到SVG/DXF/PDF/EPS list_illustrator_scripts --列出以前生成的Illustrator脚本
市场与包装(3)
package_design --将设计捆绑到市场就绪的包中(多格式文件、预览图像、README、列表元数据、zip存档) generate_listing_description --为Etsy、Cults3D或Gumroad生成SEO优化的列表描述 convert_design_format --在格式之间转换(SVG↔DXF,G代码→SVG预览)
CNCjs的Windows PC安装程序
- Node.js (建议使用LTS,v18+)--从下载https://nodejs.org
- CNCjs --设置好Node.js后通过npm安装:
npm install -g cncjs或者从CNCjs GitHub发布页面下载桌面应用程序安装程序。
- 适用于FoxAlien XE Ultra的USB/串行驱动程序 --可能是以下之一:
- CH340 驱动程序(在FoxAlien板上最常见)--从制造商网站下载 - CP210x 驱动程序(如果它使用SiLabs芯片) - Windows 10/11可能会自动安装这些,但如果您的板在设备管理器的“端口(COM和LPT)”下没有显示,请手动安装驱动程序
安装后快速启动:
cncjs然后打开 http://localhost:8000 在您的浏览器中。您的FoxAlien将显示为COM端口(例如。, COM3).选择它,将波特率设置为 115200,控制器类型 Grbl,并连接。
可选但推荐:
- Chrome/Edge --CNCjs web UI在Chromium浏览器中效果最佳
- python (有时需要
node-gyp在npm安装过程中构建本机模块)
MCP服务器设置
npm install
npm run build注册克劳德代码:
claude mcp add cncjs-mcp node /path/to/cncjs-mcp/build/index.js环境变量
CNCJS_URL--CNCjs服务器URL(默认值:http://localhost:8000)CNCJS_TOKEN--用于CNCjs身份验证的可选JWT令牌
