Elegoo Mcp Server

Elegoo MCP 服务

一个本地 MCP（模型上下文协议）服务，可通过 SDCP 协议控制 Elegoo 3D 打印机。

100% 本地运行——不依赖云服务。

⚠️ 你的电脑和打印机必须连接到同一个本地网络（WiFi 或以太网）。

已使用 Elegoo Centauri Carbon 和 Claude Desktop 进行测试。应该也适用于任何兼容 MCP 的客户端（VS Code、Cursor 等）。

功能

功能	支持	备注
多打印机管理	✓	添加、移除和切换打印机
连接/断开连接	✓	WebSocket 连接
获取状态	✓	温度、位置、打印进度
暂停/继续/停止打印	✓
开始打印	✓	使用打印机上的文件
灯光控制	✓	开/关
列出文件	✓	已打印文件带缩略图
摄像头视频流	✓	实时 MJPEG URL
温度控制	✗	SDCP 不支持
风扇控制	✗	SDCP 不支持
速度控制	✗	SDCP 不支持
移动/归零	✗	SDCP 不支持
删除文件	✗	SDCP 不支持

标记为 ✗ 的功能必须通过打印机触摸屏控制。

前置条件

• Node.js 18+
• Elegoo Centauri Carbon（或兼容的 SDCP 打印机）
• 打印机连接到同一个本地网络

安装

选项 1：npx（推荐）

无需安装！直接配置 Claude Desktop 即可。

选项 2：全局安装

npm install -g elegoo-mcp-server

选项 3：从源代码安装

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

Claude Desktop 配置

添加到你的 Claude Desktop 配置文件：

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

使用 npx（推荐）

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

使用全局安装

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

使用本地克隆

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

保存后重启 Claude Desktop。

快速开始

1. 安装 MCP（见上文）
2. 重启 Claude Desktop
3. 说：“连接到我的 Elegoo 打印机”
4. Claude 会询问打印机的 IP 地址
5. 完成！你的打印机已保存，可供后续会话使用。

使用示例

"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"

可用工具

启动

工具	说明
elegoo_start	初始化并连接到默认打印机
elegoo_setup	配置新打印机
elegoo_select	在已保存的打印机之间切换

配置

工具	说明
elegoo_add_printer	添加打印机
elegoo_remove_printer	移除打印机
elegoo_list_printers	列出已保存的打印机
elegoo_set_default	设置默认打印机
elegoo_update_printer	更新打印机设置

打印机控制

工具	说明
elegoo_connect	连接到打印机
elegoo_disconnect	断开连接
elegoo_status	获取完整状态（温度、位置、进度）
elegoo_wake	唤醒休眠中的打印机
elegoo_pause	暂停打印
elegoo_resume	继续打印
elegoo_stop	取消打印
elegoo_start_print	开始打印任务
elegoo_set_light	开/关灯光
elegoo_list_files	列出文件/打印历史（带 ✓ 的文件表示已打印）
elegoo_view_file	查看文件缩略图（仅限已打印文件）
elegoo_camera	获取摄像头视频流 URL

协议

此服务实现 SDCP（智能设备控制协议）v3.0.0。

• 连接： 位于 ws://{IP}:3030/websocket 的 WebSocket
• 配置存储： ~/.elegoo/config.json

已知问题

• 固件 v1.1.29： 打印期间灯光控制可能无法使用。固件 v1.1.25 可正常工作。

作者

由 @skribascode 通过氛围编程完成 ;-)

致谢

• SDCP 文档：OpenCentauri
• 协议参考：sdcp-centauri-carbon

许可证

MIT