AI导哈

3D打印机控制服务

Elegoo MCP Server是一个本地MCP（模型上下文协议）服务器，用于通过SDCP协议控制Elegoo 3D打印机，支持多打印机管理、连接/断开、打印状态监控、暂停/恢复/停止打印、文件列表查看等功能。

  • by skribascode
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 skribascode/elegoo-mcp-server

使用说明

Elegoo MCP服务器

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

100%本地-无云依赖。

⚠️ 您的计算机和打印机必须位于同一本地网络（WiFi或以太网）上。

经过测试 Elegoo Centauri碳纤维 和 克劳德桌面。应适用于任何兼容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桌面配置

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %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. 重新启动克劳德桌面
  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。

  • 连接： Websocket和 ws://{IP}:3030/websocket
  • 配置存储： ~/.elegoo/config.json

已知问题

  • 固件v1.1.29： 打印过程中灯光控制可能不起作用。固件v1.1.25工作正常。

作者

由……制造 @斯屈巴斯科德 在vibe编码中；-)

学分

许可证

麻省理工学院

相关 MCP