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