io.github.zackpeters93/ugs-mcp

Official

by zackpeters93 · Python

CNC machine control via Universal G-code Sender. Jog, home, run files with hardware safety tokens.

io.github.zackpeters93/ugs-mcp MCP Server

This MCP server provides CNC machine control via Universal G-code Sender. It supports jogging, homing, and running G-code files, using hardware safety tokens to govern execution. The server is positioned around GRBL/Universal G-code Sender workflows and exposes MCP tooling for CNC milling scenarios.

🛠️ Key Features

CNC machine control through Universal G-code Sender
Jogging and homing operations
Run G-code files with hardware safety tokens

🚀 Use Cases

Controlling a CNC machine during setup via jog/home
Executing G-code files for CNC milling tasks
Integrating GRBL/Universal G-code Sender workflows into MCP-based systems

⚡ Developer Benefits

Direct mapping to CNC control actions (jog, home, run files)
Safety-gated execution using hardware safety tokens

⚠️ Limitations

Limited details available: no tool count or additional capabilities were provided in the source data

Topics

claudecncgcodegrblmcpcncmillinguniversal-gcode-sender

Install

Configuration

Environment variables

UGS_HOST

UGS Pendant host address

UGS_PORT

UGS Pendant port (default: 8080)

MACROS_DIR

Directory for saved G-code macros

RAPID_SPEED_MM_MIN

Rapid speed in mm/min used for return-to-zero (default: 5000)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ugs-mcp": {
      "command": "uvx",
      "args": [
        "ugs-mcp"
      ],
      "env": {
        "UGS_HOST": "<YOUR_UGS_HOST>",
        "UGS_PORT": "<YOUR_UGS_PORT>",
        "MACROS_DIR": "<YOUR_MACROS_DIR>",
        "RAPID_SPEED_MM_MIN": "<YOUR_RAPID_SPEED_MM_MIN>"
      }
    }
  }
}