SlicerBridge

Name: SlicerBridge
Author: UnicornGraveyard

本地服务

github.com媒体与设计3今天更新

代码仓库访问官网

关于 SlicerBridge

SlicerBridge 是用于将多色 3MF 项目转换为打印机专用文件的命令行工具，可保留涂色并检查输出。它支持来自 Bambu Studio、OrcaSlicer 及列出的分支版本的项目，输出覆盖 30 款打印机。

主要功能

01为 30 款打印机转换项目
02保留颜色分配和涂色三角面
03沿用兼容的打印设置
04写入前检查文件
05可选切片与品牌切片器验证

适用场景

01为不同打印机准备多色模型
02重新适配已有的打印机专用 3MF
03分享前检查输出文件

MCP 相关

SlicerBridge 内置本地 stdio MCP 服务。MCP 客户端可检查模型、转换为指定打印机格式并读取检查结果；处理在本地通过已安装的切片器完成。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "unicorngraveyard-slicerbridge": {
      "command": "uvx",
      "args": [
        "slicerbridge"
      ],
      "env": {
        "SLICERBRIDGE_ORCASLICER": "<SLICERBRIDGE_ORCASLICER>",
        "SLICERBRIDGE_BAMBU_STUDIO": "<SLICERBRIDGE_BAMBU_STUDIO>",
        "SLICERBRIDGE_PRUSASLICER": "<SLICERBRIDGE_PRUSASLICER>",
        "SLICERBRIDGE_SNAPMAKER_ORCA": "<SLICERBRIDGE_SNAPMAKER_ORCA>",
        "SLICERBRIDGE_CREALITY_PRINT": "<SLICERBRIDGE_CREALITY_PRINT>",
        "SLICERBRIDGE_ELEGOOSLICER": "<SLICERBRIDGE_ELEGOOSLICER>",
        "SLICERBRIDGE_ANYCUBIC_SLICER_NEXT": "<SLICERBRIDGE_ANYCUBIC_SLICER_NEXT>",
        "SLICERBRIDGE_FLASH_STUDIO": "<SLICERBRIDGE_FLASH_STUDIO>",
        "SLICERBRIDGE_QIDI_STUDIO": "<SLICERBRIDGE_QIDI_STUDIO>"
      }
    }
  }
}

启动命令uvx slicerbridge

需要配置的环境变量

SLICERBRIDGE_ORCASLICERWhere OrcaSlicer 2.4.2, which writes the files for Creality, Elegoo, Anycubic, Flashforge and QIDI printers is installed (default: /Applications)

SLICERBRIDGE_BAMBU_STUDIOWhere Bambu Studio, which writes the files for Bambu Lab printers is installed (default: /Applications)

SLICERBRIDGE_PRUSASLICERWhere PrusaSlicer, which builds the Prusa printer profiles is installed (default: /Applications)

SLICERBRIDGE_SNAPMAKER_ORCAWhere Snapmaker Orca, which slices the Snapmaker U1 file is installed (default: /Applications)

SLICERBRIDGE_CREALITY_PRINTWhere Creality Print, for brand-check only is installed (default: /Applications)

SLICERBRIDGE_ELEGOOSLICERWhere ElegooSlicer, for brand-check only is installed (default: /Applications)

SLICERBRIDGE_ANYCUBIC_SLICER_NEXTWhere Anycubic Slicer Next, for brand-check only is installed (default: /Applications)

SLICERBRIDGE_FLASH_STUDIOWhere Flash Studio (Orca-Flashforge), for brand-check only is installed (default: /Applications)

SLICERBRIDGE_QIDI_STUDIOWhere QIDI Studio, for brand-check only is installed (default: /Applications)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypislicerbridge0.4.1stdio

工具

收录的工具列表 · 更新于今天

参数	类型	必填	说明
printers	string	否	要查询哪些打印机：'all'、某个集合（popular）、某个供应商（bambu、creality、elegoo、anycubic、flashforge、qidi、prusa、snapmaker），或来自 list_printers 的打印机键（逗号分隔）。

详细介绍

SlicerBridge

输入任意多色 3MF 项目，即可为每款多色打印机输出经过检查、可直接使用的文件。

你在一款切片软件中为模型上好多色。打印模型的人可能用的是 Bambu Lab A1、Creality K2、Elegoo Centauri Carbon、QIDI Q2、Prusa XL、Snapmaker U1……他们每个人都得手动将你的项目适配到自己的打印机，猜测预设，还经常在过程中丢失颜色。

SlicerBridge 会读取你用任意切片软件（Bambu Studio、OrcaSlicer，或打印机厂商基于其中之一自行修改的版本）制作的项目，并为 30 款打印机分别生成一个文件，以对应打印机命名（My Model - Creality K2 Plus.3mf），方便下载者打开适用于自己的文件并开始打印。适用于 Bambu Lab、OrcaSlicer 系列和 U1 打印机的文件还可以再次导入，用于适配另一款打印机。每个文件都：

保留你绘制的颜色。 按顺序保留模型实际使用的耗材，并重新编码每个绘制过颜色的三角形，使其匹配。
**包含该打印机专属的设置，**由该打印机自己的切片软件写入，并包含该打印机的耗材预设。如果打印机支持相同的设置，你的打印设置（层高、墙数、填充、支撑）也会一并保留。
保留模型尺寸。 绝不缩放。若模型大于打印平台，会给出警告并提示适合平台的缩放比例。
写入前经过检查：检查颜色、绘制数据、打印盘、尺寸和设置；还可选择在该打印机的切片软件中切片，以验证颜色自动切换，并确认擦料塔不会与模型重叠。未通过检查的文件绝不会写入。

输入内容

多色 .3mf 项目，可以带绘制颜色，也可以为各个部件或对象指定颜色，并由以下任一软件保存。这些软件写入的项目格式相同。

保存软件
Bambu Studio	已测试（2.8）
OrcaSlicer	已测试（2.4.2）
QIDI Studio、Anycubic Slicer Next、ElegooSlicer、Flash Studio	已使用各软件保存的项目进行测试
SlicerBridge	适用于 Bambu Lab、OrcaSlicer 系列和 U1 打印机的文件，可再次用于适配
Creality Print	应该可用，但尚未测试：其命令行无法保存项目（告诉我们）
PrusaSlicer	尚不支持：PrusaSlicer 项目采用不同格式

如果输入的是仅含网格的 3MF（内部没有切片项目），程序会拒绝处理并说明解决方法：在切片软件中打开文件，为模型设置颜色，然后保存项目。

输出内容

打印机	键	颜色数	文件适用的切片软件	已检查的品牌切片软件
Bambu Lab A1 mini	`a1mini`	4	Bambu Studio	—
Bambu Lab A1	`a1`	4	Bambu Studio	—
Bambu Lab P1S	`p1s`	16	Bambu Studio	—
Bambu Lab P2S	`p2s`	16	Bambu Studio	—
Bambu Lab X1 Carbon	`x1c`	16	Bambu Studio	—
Bambu Lab H2S	`h2s`	16	Bambu Studio	—
Bambu Lab H2D	`h2d`	16	Bambu Studio	—
Bambu Lab H2C	`h2c`	16	Bambu Studio	—
Creality K2 Plus	`k2plus`	4	OrcaSlicer	Creality Print
Creality K2 Pro	`k2pro`	4	OrcaSlicer	Creality Print
Creality K2 SE	`k2se`	4	OrcaSlicer	Creality Print
Creality Hi	`hi`	4	OrcaSlicer	Creality Print
Creality K1C CFS	`k1c`	4	OrcaSlicer	Creality Print
Elegoo Centauri Carbon	`cc`	4	OrcaSlicer	ElegooSlicer
Anycubic Kobra S1	`kobras1`	4	OrcaSlicer	Anycubic Slicer Next
Anycubic Kobra S1 Max	`kobras1max`	4	OrcaSlicer	Anycubic Slicer Next
Anycubic Kobra 3	`kobra3`	4	OrcaSlicer	Anycubic Slicer Next
Anycubic Kobra 3 Max	`kobra3max`	4	OrcaSlicer	Anycubic Slicer Next
Anycubic Kobra X	`kobrax`	4	OrcaSlicer	Anycubic Slicer Next
Flashforge AD5X	`ad5x`	4	OrcaSlicer	Flash Studio
Flashforge Creator 5	`creator5`	4	OrcaSlicer	Flash Studio
QIDI Q2	`q2`	4	OrcaSlicer	QIDI Studio
QIDI Q2C	`q2c`	4	OrcaSlicer	QIDI Studio
QIDI Plus4	`plus4`	4	OrcaSlicer	QIDI Studio
QIDI Max4	`max4`	4	OrcaSlicer	QIDI Studio
Prusa MMU3	`mmu3`	5	PrusaSlicer	—
Prusa XL	`xl`	5	PrusaSlicer	—
Prusa Core One INDX 4T	`indx4`	4	PrusaSlicer	—
Prusa Core One INDX 8T	`indx8`	8	PrusaSlicer	—
Snapmaker U1	`u1`	4	Snapmaker Orca	—

“文件适用的切片软件”是指文件中携带其设置的切片软件。适用于 Creality、Elegoo、Anycubic、Flashforge 和 QIDI 打印机的文件由 OrcaSlicer 写入，也会在各品牌自己的切片软件中检查：请参阅 docs/brand-slicers.md，了解这些切片软件读取方式的差异，以及文件如何处理这些差异。没找到你的打印机？提出申请，或添加打印机。

安装

SlicerBridge 目前可在 macOS 上运行（Linux 和 Windows：欢迎协助），需要 Python 3.10 或更高版本。

pipx install slicerbridge                                    # or: uv tool install slicerbridge
pipx install git+https://github.com/UnicornGraveyard/SlicerBridge   # the latest from GitHub

它会使用每台打印机对应的切片软件生成设置，因此请安装所需的软件：

要写入文件的打印机	安装
Bambu Lab 打印机	Bambu Studio
Creality、Elegoo、Anycubic、Flashforge、QIDI	OrcaSlicer 2.4.2
Prusa 打印机	PrusaSlicer
Snapmaker U1	无需安装：其模板已内置

然后运行 slicerbridge doctor，查看它检测到了什么。有关详情、其他安装位置和环境变量，请参阅： docs/install.md。

使用

slicerbridge inspect model.3mf                       # colors used, plates, fit on each bed
slicerbridge convert model.3mf                       # the popular printers, into out/<model>/
slicerbridge convert "Dragon - Creality K2 Plus.3mf" --printers bambu   # retarget a file you already have
slicerbridge convert model.3mf --printers all --slice --name "My Model" --prefix "My Shop - "
slicerbridge convert model.3mf --printers creality,qidi,u1
slicerbridge printers                                # every printer, its key, engine and slicer
slicerbridge verify "out/My Model" --source model.3mf --slice
slicerbridge brand-check "out/My Model"              # slice each file in its maker's own slicer

--printers 可接受 all、popular、供应商（bambu、creality、elegoo、anycubic、flashforge、qidi、 prusa、snapmaker）或打印机键，多个值以逗号分隔。

不会执行的操作

合并颜色。 如果模型使用的耗材多于打印机可容纳的数量，该打印机将不予处理。选择合并哪两种颜色属于设计决策；请在切片软件中完成。（Prusa 打印机可使用显式的 --map。）
调整任何内容的大小。 尺寸也不会成为跳过某台打印机的理由：下载者会在其切片软件中缩放模型。
写入未通过检查的文件，也不会覆盖它未写入的文件（这些文件会移至 _previous/）。

在 Claude 或其他 AI 助手中使用

SlicerBridge 内置了本地 MCP 服务，因此助手可以检查模型、为你指定的打印机转换模型，并为你读取检查结果。它通过 stdio 在你的设备上运行，并使用你安装的切片软件：不会上传任何内容。

**Claude Code 和 Cowork：**安装 SlicerBridge 插件，它会添加服务和一个教 Claude 使用工作流的技能。需要安装 uv。

/plugin marketplace add UnicornGraveyard/SlicerBridge
/plugin install slicerbridge@slicerbridge

**其他 MCP 客户端：**运行 uvx slicerbridge mcp（安装后也可以运行 slicerbridge mcp）。Claude Desktop 等客户端的设置方法见：docs/mcp.md。它也已列入 MCP Registry，名称为 io.github.UnicornGraveyard/slicerbridge。

工作原理

每个输入的读取方式都相同：Bambu Studio、OrcaSlicer 及其分支版本都以相同的 3MF 项目格式保存文件（网格、涂装、打印板、设置）。三个引擎共用一张打印机表、一个 CLI 和一套检查项来生成输出：

orca：适用于 Bambu Lab 和 OrcaSlicer 系列打印机。每台打印机都由其对应的切片软件根据自带的预设写入一次设置（模板）。文件是源项目，包含这些设置；其中的耗材会经过精简，涂装会重新编码，并且每个打印板都会移到新底板上对应的独立打印板，同时为擦料塔留出空间。
prusa：适用于 Prusa 多材料打印机，由 Panda2Prusa 写入 PrusaSlicer 项目，每个打印板对应一个项目。
u1：适用于 Snapmaker U1，使用 bl2u1 的 U1 模板。

docs/how-it-works.md 介绍了每个步骤；docs/checks.md 列出了所有检查项。

参与贡献

欢迎提交错误报告、打印机需求和拉取请求：请从 CONTRIBUTING.md 开始。请勿在问题中附上付费或受许可保护的模型；测试套件会自行构建项目。

许可与致谢

SlicerBridge 是基于 GNU GPL v3 or later 发布的免费软件。它基于 Panda2Prusa（MIT，随项目附带）和 bl2u1（GPLv3，其 U1 模板），也采用了 OrcaSlicer、 Bambu Studio 和 PrusaSlicer 项目的成果，并从你自行安装的这些软件中读取配置文件。详见 THIRD_PARTY_NOTICES.md。

由 Unicorn Graveyard 制作，因为他们希望每个 ColorStacked 模型都能送到每台打印机上。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

SlicerBridge

关于 SlicerBridge

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

SlicerBridge

输入内容

输出内容

安装

使用

不会执行的操作

在 Claude 或其他 AI 助手中使用

工作原理

参与贡献

许可与致谢

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？