SlicerBridge

Name: SlicerBridge
Author: UnicornGraveyard

ローカル

github.comメディア・デザイン31 日前に更新

リポジトリ公式サイト

SlicerBridge について

SlicerBridgeは、マルチカラーの3MFスライサープロジェクトを対応プリンター向けの検査済みファイルに変換するmacOS用コマンドラインツールです。塗り分けた色と適用可能な設定を保ち、プリンターごとのスライサー手順で出力を作成・検証します。アシスタント向けのローカルMCPサーバーも含みます。

主な機能

0130機種向けに3MFプロジェクトを変換
02塗り分けた色とモデルの縮尺を維持
03プリンター固有の設定とプリセットを適用
04出力を検査・検証し、任意でスライス
05ローカルMCPサーバーを実行

活用シーン

01異なるプリンターの利用者向けにモデルを準備
02プロジェクトの色とベッドへの収まりを確認
03配布前に変換ファイルを検証
04指定プリンター向けの変換をアシスタントに依頼

MCP 対応

ローカルのstdio 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_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_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.3.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 を参照してください。また、io.github.UnicornGraveyard/slicerbridge として MCP Registry にも登録されています。

動作の仕組み

すべての入力は同じ方法で読み取られます。Bambu Studio、OrcaSlicer、およびそのフォークは、同じ 3MF プロジェクト形式（メッシュ、ペイント、プレート、設定）で保存します。3 つのエンジンが出力を書き込み、1 つのプリンターテーブル、1 つの CLI、1 組のチェックを共有します。

orca：Bambu Lab および OrcaSlicer 系のプリンター向けです。各プリンターのスライサーは、それぞれに付属するプリセットから設定を一度書き込みます（テンプレート）。ファイルは、これらの設定を適用し、フィラメントを圧縮し、ペイントを再エンコードしたソースプロジェクトです。各プレートは、新しいベッド上でプライムタワー用のスペースを確保し、それぞれ独立したプレートに移されます。
prusa：Panda2Prusa が PrusaSlicer プロジェクトとして書き出す Prusa マルチマテリアルプリンター向けです。プレートごとに 1 つのプロジェクトが作成されます。
u1：bl2u1 の U1 テンプレートを使用する Snapmaker 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 を参照してください。

すべての ColorStacked モデルをあらゆるプリンターで使えるようにする必要があった Unicorn Graveyard が制作しました。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

SlicerBridge

SlicerBridge について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

SlicerBridge

入力できるもの

出力内容

インストール

使い方

対応していないこと

Claude または別の AI アシスタントから使用する

動作の仕組み

貢献

ライセンスとクレジット

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？