mcp/3d-printer Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
mcp/3d-printermcp
将MCP连接到主流3D打印机API（Orca、Bambu、OctoPrint、Klipper等），支持打印控制、状态监控及STL文件高级操作（缩放、旋转、切片、基础扩展等），包含切片和可视化功能。
7 次收藏下载次数: 0状态：社区镜像维护者：mcp仓库类型：镜像最近更新：10 个月前
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服务器更安全？
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"