mcp/3d-printer Docker Image Overview

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 相关镜像 →