Elegoo Mcp Server

Elegoo MCP Server

A local MCP (Model Context Protocol) server for controlling Elegoo 3D printers via the SDCP protocol.

100% local - no cloud dependencies.

⚠️ Your computer and printer must be on the same local network (WiFi or Ethernet).

Tested with Elegoo Centauri Carbon and Claude Desktop. Should work with any MCP-compatible client (VS Code, Cursor, etc.).

Features

Feature	Supported	Notes
Multi-printer management	✓	Add, remove, switch between printers
Connect/Disconnect	✓	WebSocket connection
Get Status	✓	Temperatures, position, print progress
Pause/Resume/Stop Print	✓
Start Print	✓	From files on printer
Light Control	✓	On/Off
List Files	✓	With thumbnails for printed files
Camera Stream	✓	Live MJPEG URL
Temperature Control	✗	Not supported via SDCP
Fan Control	✗	Not supported via SDCP
Speed Control	✗	Not supported via SDCP
Movement/Homing	✗	Not supported via SDCP
Delete Files	✗	Not supported via SDCP

Features marked ✗ must be controlled via the printer touchscreen.

Prerequisites

• Node.js 18+
• Elegoo Centauri Carbon (or compatible SDCP printer)
• Printer on same local network

Installation

Option 1: npx (Recommended)

No installation needed! Just configure Claude Desktop directly.

Option 2: Global install

npm install -g elegoo-mcp-server

Option 3: From source

git clone https://github.com/skribascode/elegoo-mcp-server.git
cd elegoo-mcp-server
npm install
npm run build

Configuration for Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (recommended)

{
  "mcpServers": {
    "elegoo": {
      "command": "npx",
      "args": ["elegoo-mcp-server"]
    }
  }
}

Using global install

{
  "mcpServers": {
    "elegoo": {
      "command": "elegoo-mcp-server"
    }
  }
}

Using local clone

{
  "mcpServers": {
    "elegoo": {
      "command": "node",
      "args": ["/path/to/elegoo-mcp-server/dist/index.js"]
    }
  }
}

Restart Claude Desktop after saving.

Quick Start

1. Install the MCP (see above)
2. Restart Claude Desktop
3. Say: "Connect to my Elegoo printer"
4. Claude will ask for your printer's IP address
5. Done! Your printer is saved for future sessions.

Usage Examples

"What's the printer status?"
"Pause the print"
"Resume printing"
"Turn on the light"
"Show me the files on the printer"
"Start printing benchy.gcode"
"Show me the camera"

Available Tools

Startup

Tool	Description
elegoo_start	Initialize and connect to default printer
elegoo_setup	Configure a new printer
elegoo_select	Switch between saved printers

Configuration

Tool	Description
elegoo_add_printer	Add a printer
elegoo_remove_printer	Remove a printer
elegoo_list_printers	List saved printers
elegoo_set_default	Set default printer
elegoo_update_printer	Update printer settings

Printer Control

Tool	Description
elegoo_connect	Connect to printer
elegoo_disconnect	Disconnect
elegoo_status	Get full status (temps, position, progress)
elegoo_wake	Wake up sleeping printer
elegoo_pause	Pause print
elegoo_resume	Resume print
elegoo_stop	Cancel print
elegoo_start_print	Start a print job
elegoo_set_light	Turn light on/off
elegoo_list_files	List files / print history (files with ✓ = already printed)
elegoo_view_file	View file thumbnail (printed files only)
elegoo_camera	Get camera stream URL

Protocol

This server implements SDCP (Smart Device Control Protocol) v3.0.0.

• Connection: WebSocket at ws://{IP}:3030/websocket
• Config storage: ~/.elegoo/config.json

Known Issues

• Firmware v1.1.29: Light control may not work during printing. Firmware v1.1.25 works correctly.

Author

Made by @skribascode in vibe coding ;-)

Credits

• SDCP documentation: OpenCentauri
• Protocol reference: sdcp-centauri-carbon

License

MIT