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.

CNC machine control via Universal G-code Sender with jog, home, and file-run commands.

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)

claude_desktop_config.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>"
      }
    }
  }
}