Bambu Lab MCP Server

Bambu实验室MCP服务器

Bambu Lab 3D打印机的模型上下文协议服务器

   ](https://nodejs.org/)

_通过Claude AI完全控制Bambu Lab打印机——MQTT、FTP、摄像头、AMS和X.509身份验证_

特性 · 快速开始 · 工具 · 背景

______________________________________________________________________

概述

Bambu Lab 3D打印机（P1P、P1S、X1C、A1、A1 Mini）的完整MCP服务器。通过本地MQTT进行连接，以实现实时控制和监控，通过FTPS文件上传和X.509证书签名来绕过固件身份验证限制。

25工具 涵盖打印控制、状态监控、摄像头、AMS灯丝管理、温度、LED控制等。

背景

2025年1月，Bambu Lab推出了需要本地局域网打印机控制身份验证的固件更新， 破坏所有第三方工具 --OctoPrint，家庭助理集成，自定义脚本，一切。

社区研究人员从Bambu Connect桌面应用程序中提取了X.509证书和私钥，恢复了第三方访问。此MCP服务器基于该工作构建，通过Claude提供全面的打印机控制。

主要参考文献：

• Hackaday：Bambu Connect的X.509认证证书和私钥提取 --开始解决方法的文章
• OpenBambuAPI --反向工程MQTT协议文档
• 班布节点 --Bambu打印机的TypeScript库

特性

• 本地MQTT控制 --打印、暂停、恢复、停止、速度配置文件、G代码执行
• 实时状态 --使用缓存+新状态工具从MQTT报告中连续缓存
• 相机控制 --开始/停止录制和延时
• AMS管理 --更换灯丝托盘，卸载灯丝
• FTP文件上传 --FTPS上传到打印机SD卡（端口990）
• X.509签名 --通过证书签名绕过固件身份验证限制
• 温度控制 --设置带安全限制的喷嘴/床温度
• 对象跳过 --跳过失败的对象而不停止打印
• 速度曲线 --静音、标准、运动、Ludicrous（或原始百分比）
• LED控制 --腔室和工作灯
• 安全确认 --阻止G代码、温度限制、路径穿越防止

快速开始

先决条件

• Node.js 18+
• 本地网络上的Bambu Lab打印机
• 开发人员模式已启用 在打印机上（推荐--设置>仅局域网>开发人员模式）

安装

git clone https://github.com/schwarztim/bambu-mcp.git
cd bambu-mcp
npm install
npm run build

选项A：开发者模式（推荐）

在打印机上启用开发人员模式，然后使用LAN凭据进行配置：

# Grab these from your printer screen:
#   IP Address:    WLAN → IP
#   Access Code:   WLAN → Access Code (8-digit)
#   Serial Number: Settings → Device → Serial Number

添加 ~/.claude/user-mcps.json:

{
  "mcpServers": {
    "bambu-lab": {
      "command": "node",
      "args": ["/path/to/bambu-mcp/dist/index.js"],
      "env": {
        "BAMBU_LAB_MQTT_HOST": "192.168.1.100",
        "BAMBU_LAB_MQTT_PASSWORD": "YOUR_ACCESS_CODE",
        "BAMBU_LAB_DEVICE_ID": "YOUR_SERIAL_NUMBER"
      }
    }
  }
}

开发者模式提供最可靠的体验。所有MQTT命令都会自动使用X.509证书进行签名。

选项B：浏览器登录（无开发者模式）

如果你不想启用开发人员模式（例如，为了保持Bambu Handy的工作状态），你可以通过浏览器登录进行身份验证：

npm run setup

这将打开Firefox（代替Chrome使用，以避免谷歌SSO机器人检测），允许您登录Bambu Lab帐户，并自动发现您的打印机。凭据保存到 ~/.bambu-mcp/credentials.json 并自动加载——不需要env变量。

注： 代币有效期约为3个月。跑 npm run setup 再次刷新。

然后用Claude Code注册（不需要env变量）：

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

没有开发人员模式的限制： 印刷 .3mf 文件通过 project_file 命令需要开发人员模式。 .gcode 文件和所有其他命令（停止、暂停、恢复、状态、速度、G代码、相机、AMS）都可以在没有它的情况下工作。

工具

云API（4个工具）

打印控制（7个工具）

状态和信息（3个工具）

相机（2个工具）

AMS和Filament（2个工具）

硬件（3个工具）

连接和上传（3个工具）

建筑

Claude Code / AI
    |
    v
Bambu Lab MCP Server
  |-- Cloud API (bambulab.com)
  |-- MQTT Client (port 8883, TLS)
  |-- FTP Client (port 990, FTPS)
    |
    v
Bambu Lab Printer (P1P/P1S/X1C/A1)

运作原理

1. 消息队列遥测传输 使用LAN访问代码通过端口8883上的TLS连接到打印机
2. 状态报告包括 持续缓存 当他们谈到MQTT报告主题时
3. 在MQTT请求主题上发送命令，并使用序列ID进行响应匹配
4. 文件传输协议 通过FTPS（端口990）将文件上传到打印机SD卡
5. X.509签名 将提取的Bambu Connect证书用于经过身份验证的命令

配置

环境变量

查找打印机信息

• IP地址：打印机屏幕→ WLAN → IP
• 访问码：打印机屏幕→ WLAN → 访问代码（8位）
• 序列号：设置→ 设备→ 序列号

安全

X.509证书

此服务器包括从Bambu Connect桌面应用程序中公开提取的X.509证书。这不是秘密，这是 2025年1月公开披露 并嵌入到Bambu Connect的每个副本中。

所有MQTT命令现在 自动签名 RSA-SHA256使用此证书。这是2025年1月以后的固件所要求的——未签名的命令会被错误拒绝 84033543基本命令（停止、暂停、恢复、速度、G代码）不需要开发人员模式。

可以通过以下方式覆盖证书 BAMBU_APP_PRIVATE_KEY 和 BAMBU_APP_CERTIFICATE 如果Bambu Lab轮换凭据，则使用环境变量。集 BAMBU_LAB_USER_ID （您的数字Bambu实验室用户ID）以实现完全兼容性-通过云API找到它 /v1/design-user-service/my/preference 终点。

安全特性

• 阻止G代码：M112（紧急停止）、M502（出厂重置）、M500/M501（EEPROM）、M997（固件更新）、M999（重启）
• 温度限制：喷嘴最高温度300C，床最高温度120C
• 文件验证：只允许上传.gcode、.3mf、.stl
• 路径遍历预防：没有 .. 或FTP上传中的绝对路径

最佳实践

1. 将打印机保持在单独的VLAN上
2. 定期轮换局域网访问代码
3. 永不承诺 .env 文件（已在 .gitignore)

致谢

• 社区研究人员 谁 提取X.509证书 --使这成为可能
• OpenBambuAPI --反向工程MQTT协议文档
• Shockedrope/bambu mcp服务器 --速度剖面概念
• DMontgomery40/mcp-3D打印机服务器 --多打印机平台的启示
• 班布节点 --TypeScript Bambu库
• 竹光实验室 --用于制作出色的打印机（即使身份验证锁定很粗糙）

许可证

麻省理工学院——见 许可证 了解详情。

免责声明

与Bambu实验室无关或未经其认可。使用风险由您自行承担。