mcp/3d-printer

将MCP连接到主流3D打印机API（Orca、Bambu、OctoPrint、Klipper等），支持打印控制、状态监控及STL文件高级操作（缩放、旋转、切片、基础扩展等），包含切片和可视化功能。

6 收藏0 次下载activemcp

3D打印机MCP服务器

将MCP连接到主流3D打印机API（Orca、Bambu、OctoPrint、Klipper、Duet、Repetier、Prusa、Creality）。控制打印、监控状态，并执行STL高级操作，如缩放、旋转、区域编辑和基础扩展。包含切片和可视化功能。

什么是MCP服务器？

特性

属性	详情
镜像来源	***镜像
Docker镜像	mcp/3d-printer
作者	DMontgomery40
代码仓库	[***]
Dockerfile	[***]
Docker镜像构建方	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/3d-printer --key [***]`
许可证	GNU通用公共许可证v2.0

可用工具

服务器提供的工具	简要描述
`center_model`	平移模型使其几何中心位于原点(0,0,0)。
`confirm_temperatures`	确认G代码文件中的温度设置
`extend_stl_base`	按指定量扩展STL文件的基础
`generate_stl_visualization`	从多个角度生成STL文件的SVG可视化
`get_printer_status`	获取3D打印机的当前状态
`get_stl_info`	获取STL文件的详细信息
`lay_flat`	尝试旋转模型使其最大平面位于XY平面（Z=0）。
`merge_vertices`	合并STL文件中距离小于指定公差的顶点。
`modify_stl_section`	对STL文件的选定区域应用特定变换
`print_3mf`	在Bambu Lab打印机上打印3MF文件，可覆盖设置。
`process_and_print_stl`	处理STL文件（扩展基础）、切片、确认温度并开始打印
`rotate_stl`	围绕特定轴旋转STL模型
`scale_stl`	均匀或沿特定轴缩放STL模型
`slice_stl`	切片STL文件以生成G代码
`translate_stl`	沿特定轴移动STL模型

工具详情

工具：`center_model`

平移模型使其几何中心位于原点(0,0,0)。

参数	类型	描述
`stl_path`	`string`	要居中的STL文件路径。

工具：`confirm_temperatures`

确认G代码文件中的温度设置

参数	类型	描述
`gcode_path`	`string`	G代码文件路径
`bed_temp`	`number` 可选	预期床温
`extruder_temp`	`number` 可选	预期挤出机温度

工具：`extend_stl_base`

按指定量扩展STL文件的基础

参数	类型	描述
`extension_inches`	`number`	扩展基础的英寸数
`stl_path`	`string`	要修改的STL文件路径

工具：`generate_stl_visualization`

从多个角度生成STL文件的SVG可视化

参数	类型	描述
`stl_path`	`string`	STL文件路径
`height`	`number` 可选	每个视图的高度（像素，默认：300）
`width`	`number` 可选	每个视图的宽度（像素，默认：300）

工具：`get_printer_status`

获取3D打印机的当前状态

参数	类型	描述
`api_key`	`string` 可选	认证API密钥（默认：环境变量值）
`bambu_serial`	`string` 可选	Bambu Lab打印机序列号（默认：环境变量值）
`bambu_token`	`string` 可选	Bambu Lab打印机访问令牌（默认：环境变量值）
`host`	`string` 可选	打印机的主机名或IP地址（默认：环境变量值）
`port`	`string` 可选	打印机API端口（默认：环境变量值）
`type`	`string` 可选	打印机管理系统类型（octoprint、klipper、duet、repetier、bambu、prusa、creality）（默认：环境变量值）

工具：`get_stl_info`

获取STL文件的详细信息

参数	类型	描述
`stl_path`	`string`	STL文件路径

工具：`lay_flat`

尝试旋转模型使其最大平面位于XY平面（Z=0）。

参数	类型	描述
`stl_path`	`string`	要放平的STL文件路径。

工具：`merge_vertices`

合并STL文件中距离小于指定公差的顶点。

参数	类型	描述
`stl_path`	`string`	要修改的STL文件路径。
`tolerance`	`number` 可选	合并顶点的最大距离（毫米，默认：0.01）。

工具：`modify_stl_section`

对STL文件的选定区域应用特定变换

参数	类型	描述
`section`	`string`	要修改的区域：'top'（顶部）、'bottom'（底部）、'center'（中心）或自定义边界
`stl_path`	`string`	STL文件路径
`transformation_type`	`string`	要应用的变换类型
`custom_max_x`	`number` 可选	自定义区域边界的最大X
`custom_max_y`	`number` 可选	自定义区域边界的最大Y
`custom_max_z`	`number` 可选	自定义区域边界的最大Z
`custom_min_x`	`number` 可选	自定义区域边界的最小X
`custom_min_y`	`number` 可选	自定义区域边界的最小Y
`custom_min_z`	`number` 可选	自定义区域边界的最小Z
`value_x`	`number` 可选	X轴变换值
`value_y`	`number` 可选	Y轴变换值
`value_z`	`number` 可选	Z轴变换值

工具：`print_3mf`

在Bambu Lab打印机上打印3MF文件，可覆盖设置。

参数	类型	描述
`three_mf_path`	`string`	要打印的3MF文件路径。
`ams_mapping`	`object` 可选	覆盖AMS filament映射（例如：{"Generic PLA": 0, "Generic PETG": 1}）。
`bambu_serial`	`string` 可选	Bambu Lab打印机序列号（默认：环境变量值）
`bambu_token`	`string` 可选	Bambu Lab打印机访问令牌（默认：环境变量值）
`bed_temperature`	`number` 可选	覆盖床温（°C）。
`host`	`string` 可选	Bambu打印机的主机名或IP地址（默认：环境变量值）
`layer_height`	`number` 可选	覆盖层高（毫米）。
`nozzle_temperature`	`number` 可选	覆盖喷嘴温度（°C）。
`support_enabled`	`boolean` 可选	覆盖支撑生成。

工具：`process_and_print_stl`

处理STL文件（扩展基础）、切片、确认温度并开始打印

参数	类型	描述
`extension_inches`	`number`	扩展基础的英寸数
`stl_path`	`string`	要处理的STL文件路径
`api_key`	`string` 可选	认证API密钥（默认：环境变量值）
`bed_temp`	`number` 可选	预期床温
`extruder_temp`	`number` 可选	预期挤出机温度
`host`	`string` 可选	打印机的主机名或IP地址（默认：环境变量值）
`port`	`string` 可选	打印机API端口（默认：环境变量值）
`type`	`string` 可选	打印机管理系统类型（默认：环境变量值）

工具：`rotate_stl`

围绕特定轴旋转STL模型

参数	类型	描述
`stl_path`	`string`	STL文件路径
`rotate_x`	`number` 可选	绕X轴旋转角度（度）
`rotate_y`	`number` 可选	绕Y轴旋转角度（度）
`rotate_z`	`number` 可选	绕Z轴旋转角度（度）

工具：`scale_stl`

均匀或沿特定轴缩放STL模型

参数	类型	描述
`stl_path`	`string`	STL文件路径
`scale_factor`	`number` 可选	应用的均匀缩放因子
`scale_x`	`number` 可选	X轴缩放因子（覆盖X轴的scale_factor）
`scale_y`	`number` 可选	Y轴缩放因子（覆盖Y轴的scale_factor）
`scale_z`	`number` 可选	Z轴缩放因子（覆盖Z轴的scale_factor）

工具：`slice_stl`

切片STL文件以生成G代码

参数	类型	描述
`stl_path`	`string`	要切片的STL文件路径
`slicer_path`	`string` 可选	切片器可执行文件路径（默认：环境变量值）
`slicer_profile`	`string` 可选	用于切片的配置文件（默认：环境变量值）
`slicer_type`	`string` 可选	切片器类型（prusaslicer、cura、slic3r、orcaslicer）（默认：环境变量值）

工具：`translate_stl`

沿特定轴移动STL模型

参数	类型	描述
`stl_path`	`string`	STL文件路径
`translate_x`	`number` 可选	沿X轴平移（毫米）
`translate_y`	`number` 可选	沿Y轴平移（毫米）
`translate_z`	`number` 可选	沿Z轴平移（毫米）

使用此MCP服务器

json
{
  "mcpServers": {
    "3d-printer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BAMBU_SERIAL",
        "-e",
        "PRINTER_HOST",
        "-e",
        "PRINTER_TYPE",
        "-e",
        "BAMBU_TOKEN",
        "mcp/3d-printer"
      ],
      "env": {
        "BAMBU_SERIAL": "YOUR_BAMBU_SERIAL",
        "PRINTER_HOST": "REAL",
        "PRINTER_TYPE": "bambu",
        "BAMBU_TOKEN": "YOUR_BAMBU_TOKEN"
      }
    }
  }
}

为什么使用Docker运行MCP服务器更安全？

查看更多 3d-printer 相关镜像 →

networkcloudmanager/pdf-printer

by networkcloudmanager

暂无描述

10K+ pulls

上次更新：5 个月前

fedeltapos/printer-server

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker加速体验非常流畅，大镜像也能快速完成下载。"

常见问题

Q1:轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

Q2:轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

Q3:流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

Q4:410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

Q5:manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

Q6:镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像加速服务

Windows/Mac

在 Docker Desktop 配置镜像加速

Docker Compose

Docker Compose 项目配置加速

K8s Containerd

Kubernetes 集群配置 Containerd

宝塔面板

在宝塔面板一键配置镜像加速

群晖

Synology 群晖 NAS 配置加速

飞牛

飞牛 fnOS 系统配置镜像加速

极空间

极空间 NAS 系统配置加速服务

爱快路由

爱快 iKuai 路由系统配置加速

绿联

绿联 NAS 系统配置镜像加速

威联通

QNAP 威联通 NAS 配置加速

Podman

Podman 容器引擎配置加速

Singularity/Apptainer

HPC 科学计算容器配置加速

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名加速

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

3d-printer Docker 镜像下载 - 轩辕镜像

3d-printer 镜像详细信息和使用指南

3d-printer 镜像标签列表和版本信息

3d-printer 镜像拉取命令和加速下载

3d-printer 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

3d-printer 镜像详细信息

3d-printer 镜像标签列表

3d-printer 镜像使用说明

3d-printer 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南

相关 Docker 镜像推荐

3d-printer 镜像详细说明

3d-printer 使用指南

3d-printer 配置说明

3d-printer 官方文档

3D打印机MCP服务器

特性

可用工具

工具详情

工具：center_model

工具：confirm_temperatures

工具：extend_stl_base

工具：generate_stl_visualization

工具：get_printer_status

工具：get_stl_info

工具：lay_flat

工具：merge_vertices

工具：modify_stl_section

工具：print_3mf

工具：process_and_print_stl

工具：rotate_stl

工具：scale_stl

工具：slice_stl

工具：translate_stl