Skip to main content
Glama
dmikushin

orca-slicer-mcp

by dmikushin

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CREALITY_SSH_HOSTNoSSH alias of the host running the Creality docker stack.t580
CREALITY_GCODE_DIRNoUpload directory on the printer, used to build the printprt path./usr/data/printer_data/gcodes
CREALITY_PROXY_CONTAINERNoDocker container serving the web UI; talked to directly, bypassing oauth2-proxy.creality-proxy

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
start_sessionA

Start a private Xvfb display with openbox and launch OrcaSlicer on it.

Must be called before any other tool. Dismisses the first-run SSL and update dialogs. Returns a status string.

stop_sessionA

Terminate OrcaSlicer, openbox and Xvfb, freeing the display.

session_statusA

Report whether a session is running and list its top-level windows.

screenshotA

Capture the current OrcaSlicer screen and return it as a PNG image.

import_modelA

Import a model (STL/OBJ/3MF/STEP/AMF/SVG) into the running instance.

Delivers the file path to the already-running OrcaSlicer over the single-instance DBus channel (orca-slicer <path> with single-instance mode enabled in the app config), which routes it to Plater::load_files - no coordinate clicking. Waits until a top-level window title reflects the loaded model.

export_gcodeA

Slice the current plate and export G-code to an absolute path.

Sends a single orca-cmd:export:<path> command over the single-instance DBus channel. Inside OrcaSlicer this slices the current plate and writes the G-code straight to (Plater::export_gcode_to), bypassing the file dialog entirely. Completion is detected by the G-code file appearing on disk. Returns a summary parsed from the generated G-code header.

process_modelA

Convenience: import a model then slice + export G-code in one call.

print_gcodeA

Send a local .gcode file to the Creality printer and start printing it.

Reaches the printer's web UI through the docker container on the configured SSH host, bypassing the public oauth2-proxy gate, and drives the same two web actions a human would: upload the file, then start the print.

Set start=False to upload only and leave the file staged on the printer.

Configuration (environment variables): CREALITY_SSH_HOST (default t580), CREALITY_PROXY_CONTAINER (default creality-proxy), CREALITY_GCODE_DIR (default /usr/data/printer_data/gcodes).

clickA

Click at absolute screen coordinates (button 1=left, 3=right).

type_textC

Type literal text into the focused widget.

press_keyA

Send a key or chord in xdotool syntax (e.g. 'ctrl+i', 'Return', 'Escape').

zoomC

Zoom the 3D view. Positive steps zoom in, negative out, over (x,y).

When x/y are left at -1 the screen centre of the active session is used.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dmikushin/orca-slicer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server