zackpeters93/ugs-mcp

What it does

This MCP server provides Claude with the ability to control CNC machines running GRBL firmware through the Universal Gcode Sender interface. It enables direct interaction with CNC hardware for motion control, toolpath inspection, and cycle time estimation. All motion commands require two-step token confirmation, ensuring Claude cannot move hardware autonomously without explicit user approval.

How to set up

Clone the repository from GitHub at zackpeters93/ugsmcp. Install dependencies using Python (indicated by the 🐍 emoji). Configure the connection to your Universal Gcode Sender instance. Ensure your CNC machine is running GRBL firmware and properly connected to UGS before initializing the MCP server. The two-step confirmation mechanism will be active by default for safety.

Key features

• Jog axes in multiple directions with precise control
• Home machine to reset coordinate system
• Load and execute Gcode files
• Inspect toolpaths before execution
• Estimate cycle times for projects
• Two-step token confirmation for all motion commands
• Full GRBL compatibility