Kiln について
Kilnは、3Dプリントのワークフロー向けオープンソースMCPサーバーです。AIエージェントによる設計、スライス、印刷キュー登録、進捗監視を支援し、各種プリンターやOctoPrint、Moonraker/Klipper、PrusaLink、USBに対応します。
主な機能
- 013Dモデルの生成と設計
- 02モデルのスライスと印刷登録
- 03プリンターとカメラの監視
- 04プリンターの検出と設定
- 05設計バージョンの保存と比較
- 06複数のプリンター接続方式に対応
活用シーン
- 01説明からオブジェクトを設計して印刷
- 02設定済みプリンターへスライス済みデータを送信
- 03印刷状況の監視と障害への対応
- 04設計バージョンの比較と変更の復元
MCP 対応
MCP経由で、設計、スライス、プリンター管理、印刷監視のツールをAIエージェントに公開します。これらのツールは`kiln serve`から利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx kiln3dKILN_PRINTER_HOSTURL of your 3D printer (OctoPrint, Moonraker, Creality, or Prusa Link)KILN_PRINTER_API_KEYシークレットAPI key for your printer's REST APIKILN_PRINTER_TYPEPrinter type: octoprint, moonraker, creality, bambu, prusalink, elegoo, or serialローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
468掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| detail | string | いいえ | |
| printer_name | any | いいえ |
詳細
3Dプリント向けのオープンソースMCPサーバーです。
アイデアから実物まで、その間のあらゆるバージョンも。
Kilnを使うと、AIエージェント(ChatGPT、Claude Desktop、Claude Code、Codex、Cursor、Gemini、Grok、または任意のカスタムMCPクライアント)が、Bambu Lab、Creality、Prusa、Elegoo、Voron、Sovol、AnkerMake、Artillery、FlashForge、QIDI、RatRig、SparkXなどの実際の3Dプリンターを最初から最後まで操作できます。OctoPrint、Moonraker/Klipper、PrusaLink、Direct USBに対応しています。
1回の会話で、エージェントはパーツを設計し、スライスし、適切なプリンターにジョブを登録し、カメラを監視し、失敗から復旧して、完成品を届けることができます。途中で人が介在する必要はありません。
AIエージェントとしてこれを読んでいますか? kiln3d.com/agentsは、あなたを実行する人ではなく、あなたに向けて書かれています。インストール、MCPの設定、設計からプリントまでの手順、そしてKilnが拒否する操作とその理由を詳しく説明しています。
pip install kiln3d
「愛犬Ashの写真入りコースター」—たった一文で、最初から最後まで。
デモを見る →
**3DプリントのためのGitなら、すべてのバージョンを残せます。**デザインをブランチしてリスクのあるアイデアを試し、数値で任意の2つのバージョンを比較し、プリントに成功した方をマージして、いつでも変更を取り消せます。仕組みを見る →
Kilnはオープンに開発されています。3Dプリントがもっと楽しくなったり、面倒を解消できたりしたなら、リポジトリに⭐を付けていただくと、次のメーカーがKilnを見つけやすくなります。
クイックスタート
Claude Desktop をお使いですか? Kiln をワンクリックでインストールできます。 kiln.mcpb をダウンロードしてダブルクリックすると、Claude Desktop が Kiln をインストールして接続します(対象は Claude Desktop のみです。以下の手順 1 と 2 は、Codex やその他すべての AI アプリを接続する方法です)。そのため、これらの手順は不要です。残る作業は 2 つあります。OpenSCAD のインストールと Kiln の利用規約への同意です。コマンドを実行すると規約が表示され、同意を入力するよう求められます。AI ではなく、ご自身で行う必要があるのはそのためです:uvx --from kiln3d kiln accept-terms。バンドルとこのコマンドはどちらも uv で実行します。無料で、リンク先には各プラットフォーム向けのワンライナーインストール方法があります。Claude Desktop に「サーバーの起動に失敗しました」と表示される場合は、uv がインストールされていません。uv をインストールして再起動してください。アップデートは拡張機能とともに提供されるため、kiln self-update では更新されません。
ChatGPT、Claude、Gemini、Grok、または Cursor をお使いですか? インストールは不要です。 アプリ内で Kiln のアドレス https://api.kiln3d.com/mcp を追加してサインインしてください。パーツを設計し、印刷可能か確認して、3D で表示します。アプリが表示に対応していれば、チャット内でそのまま確認できます。各アプリのページには、そのアプリで確認できた内容が正確に記載されています:ChatGPT、Claude、Codex、Cursor、Gemini、Grok。お使いのプリンターで印刷するには、プリンターのそばにあるコンピューターで以下の 3 つの手順を実行してください。
それ以外の方は、3 つの手順を実行してください。その後、AI に何か作るよう頼みましょう。
1. インストール
pip install kiln3d
2. AI を接続 — Kiln は Claude Desktop、Claude Code、Codex 内に自動で設定されます。
kiln signin # create your free account
kiln install-mcp # connects Kiln to your AI apps
AI アプリを再起動すると、プリンターを操作できるようになります。(Claude Code と Codex なら、このセットアップ全体を実行することもできます — 1 つのプロンプトで済む方法は kiln3d.com/install にあります。)別の MCP クライアントをお使いですか? kiln install-mcp --print を実行すると設定が表示されます。または、以下を手動で貼り付けてください。
MCP 設定を手動で行う(任意のクライアント、サインイン不要)
{
"mcpServers": {
"kiln": {
"command": "python3",
"args": ["-m", "kiln", "serve"]
}
}
}
インストール不要にしたい場合は? コマンドをインストール不要のランナーに置き換えます — "command": "uvx"、"args": ["kiln3d", "serve"](Python)、または "command": "npx"、"args": ["kiln3d"](Node)を指定します。同じサーバーを使えるため、pip install は不要です。
これを Claude Desktop、Claude Code、Codex、Cursor、または MCP 対応エージェントに追加します。サインインするまでは無料プランで実行されます。
3. 頼む — 以下のような文をエージェントに貼り付けます。あとは Kiln におまかせください。
犬の写真をあしらったコースターを作って
これで一連の操作は完了です。AI が設計、スライス、印刷を行うため、CLI を操作する必要はありません。OS 別の手順(Windows、WSL 2、Linux)は kiln3d.com/install をご覧ください。
ヒント
kiln doctorはセットアップ全体をチェックし、修正が必要な箇所を正確に知らせます。新しいリリースが公開されたら、kiln self-updateでその場でアップグレードできます。
自分で操作したい場合(CLI の概要)
# Discover printers on your network (mDNS + HTTP probe)
kiln discover
# Add your printer, saying which printer it is (see "Supported Printers")
kiln auth --name my-printer --host http://octopi.local --type octoprint --api-key YOUR_KEY --printer-model "Ender 3"
# Other types:
# kiln auth --name prusa --host http://192.168.1.100 --type prusalink --api-key YOUR_KEY --printer-model MK4
# kiln auth --name klipper --host http://192.168.1.100:7125 --type moonraker --printer-model "Voron 2.4"
# kiln auth --name bambu --host 192.168.1.100 --type bambu --access-code LAN_CODE --serial SERIAL --printer-model P1S
# A printer Kiln doesn't list yet: add who makes it, e.g. --printer-make Anycubic --printer-model "Kobra X"
kiln status # Printer state + job progress
kiln upload model.gcode # Upload a file
kiln print model.gcode # Start printing
kiln slice model.stl --print-after # Slice an STL and print in one step
kiln print *.gcode --queue # Batch print
kiln wait # Monitor a running print
kiln snapshot --output photo.jpg # Webcam snapshot
kiln history --status completed # Print history
kiln park --plan # Describe the safe park, send nothing; then --step 1, 2, 3
kiln home --plan # Same for the Home button; --plate-clear where Z homes onto the plate
kiln filament wipe --plan # Same for the wipe-pad pass; --plate-clear where its plan presses the plate
# Every command supports --json for agent consumption
kiln status --json
グローバルオプション:--printer <name> を指定すると、コマンドごとに特定のプリンターを対象にできます。コマンドの詳細については、Project Docs をご覧ください。
特定のエージェントを接続する(Claude Code、Claude Desktop、環境変数)
Claude Code — プラグインをインストールします(初回のみ。uv がまだの場合は、先にインストールしてください。無料で、ワンライナーで完了します)。
claude plugin marketplace add codeofaxel/Kiln
claude plugin install kiln@kiln
または、手動で接続するには、.claude/settings.json(プロジェクト用)または ~/.claude/settings.json(グローバル用)に追加します。
{
"mcpServers": {
"kiln": { "command": "kiln", "args": ["serve"] }
}
}
Claude Desktop — ~/.config/Claude/claude_desktop_config.json に追加します。
{
"mcpServers": {
"kiln": {
"command": "python3",
"args": ["-m", "kiln", "serve"],
"env": {
"KILN_PRINTER_HOST": "http://192.168.1.100",
"KILN_PRINTER_API_KEY": "your_key",
"KILN_PRINTER_TYPE": "prusalink"
}
}
}
}
KILN_PRINTER_TYPE にバックエンドを設定します:octoprint、moonraker、bambu、prusalink、elegoo、duet、または usb。または、kiln setup を実行済みであれば、環境変数の設定を省略できます。
その他の LLM(OpenRouter) — Kiln は Claude だけでなく、OpenAI 互換の関数呼び出しに対応するあらゆるモデルで動作します。
export KILN_OPENROUTER_KEY=sk-or-...
kiln agent --model openai/gpt-4o
kiln agent --model meta-llama/llama-3.1-70b-instruct --tier essential
ツールの階層はモデルの能力に合わせて自動的に選択されます:小規模モデル向けのessential(15 個のツール)、中位モデル向けのstandard(60 個のツール)、高性能モデル向けのfull(135 個のツール)です。MCP 経由では、895 個すべてのツールを kiln serve で利用できます。
プラットフォームとプリンターの設定に関する注意事項(Linux/WSL 2、Ethernet 専用、Bambu)
プリンターの種類ごとの前提条件
| プリンター | --type | 必要なもの |
|---|---|---|
| Prusa MK4/XL/Mini+ | prusalink | IP と API キー(LCD の Settings › Network › PrusaLink) |
| OctoPrint(すべてのプリンター) | octoprint | OctoPrint の URL と API キー(User Settings › Application Keys) |
| Klipper/Moonraker | moonraker | Moonraker の URL(通常は http://<ip>:7125) |
| Creality K1/K2/Hi/Ender V4/V3 KE | creality | IP と printer_model(例:creality_k1_max)。ローカルの Moonraker ポートを調べます |
| Bambu Lab | bambu | プリンター画面に表示される IP、シリアル番号、LAN アクセスコード。印刷の開始と制御には、LAN Only Mode と Developer Mode を有効にしてください |
| Elegoo(SDCP) | elegoo | IP のみ。認証は不要です。Neptune 4 / OrangeStorm Giga では moonraker を使用します。 |
| Duet / RepRapFirmware | duet | IP のみ。パスワードが設定されている場合はマシンのパスワードも必要です(config.g の M551)。 |
| USB 直接接続(Marlin) | usb | USB ケーブルのみ。ネットワークは不要です。Ender 3、Prusa MK3、CR-10 など、Marlin/RepRap プリンター全般に対応します。 |
Kiln に必要なのは、LAN 上で IP に到達できることだけです。Ethernet 専用のプリンターにも完全対応しています。
オプションのツール: STL → G-code のスライスには、PrusaSlicer、OrcaSlicer、または BambuStudio(brew install --cask prusaslicer)、ローカルでのテキストから 3D モデルを生成するには OpenSCAD を使用します。現行ビルドをインストールしてください(brew install --cask openscad@snapshot)。Gemini で生成したジオメトリを有効にするには、KILN_GEMINI_API_KEY を設定します。
Linux / WSL 2
pipx は Kiln を独立した環境にインストールし、kiln を PATH に追加します(pip パッケージ名は kiln3d、CLI コマンドは kiln です)。
sudo apt install pipx && pipx ensurepath
git clone https://github.com/codeofaxel/Kiln.git && cd Kiln
pipx install ./kiln
sudo apt install prusa-slicer # optional: slicing for printing
sudo snap install openscad --edge # optional: the design engine (current build)
kiln verify
# Update / uninstall
git pull && pipx install --force ./kiln
pipx uninstall kiln3d
WSL 2 のネットワーク: WSL 2 は NAT を使用するため、mDNS による検出(kiln discover)ではホームネットワーク上のプリンターを見つけられません。代わりに IP で直接接続してください(Ethernet 専用の設定と同じです)。
Ethernet 専用プリンター(Wi-Fi なし)
Kiln は Ethernet と Wi-Fi のどちらでも同じように動作し、LAN IP 経由でプリンター API と通信します。プリンターのエンドポイントが応答することを確認してから、IP で登録してください。
curl http://<ip>/api/version # OctoPrint
curl http://<ip>:7125/server/info # Moonraker / Creality (local Moonraker)
curl -H "X-Api-Key: YOUR_KEY" http://<ip>/api/v1/status # Prusa Link
# Bambu uses MQTT — ensure port 8883 is reachable: nc -zv <ip> 8883
kiln auth --name my-printer --host http://<ip> --type prusalink --api-key YOUR_KEY --printer-model MK4
PrusaSlicer が PATH にない場合:export KILN_SLICER_PATH=/path/to/prusa-slicer。
Bambu TLS とウェブカメラ
Kiln は初回接続時にプリンターの証明書をピン留めします(TOFU)。保存先は ~/.kiln/bambu_tls_pins.json です。上書き設定:
export KILN_BAMBU_TLS_MODE=ca # strict CA/hostname (usually fails on stock self-signed printers)
export KILN_BAMBU_TLS_MODE=insecure # legacy, no validation — trusted LANs only
export KILN_BAMBU_TLS_FINGERPRINT=0123abcd... # explicit SHA-256 pin
ウェブカメラのキャプチャはモデルによって異なります。A1、A1 Mini、P1P、P1S は TLS+JPEG 経由でフレームを配信するため(追加ソフトウェアは不要)、Kiln はプリンターに接続されたコンピューター上のプリントモニターで、カメラ映像をライブ動画として表示できます。X1 シリーズ(X1C、X1E)は RTSPS でストリーミングしますが、Kiln のライブ動画リレーはこれに対応していません。X1 では、Kiln は ffmpeg(brew install ffmpeg / sudo apt install ffmpeg)を使ってストリームからフレームを切り出し、スナップショットを撮影します。ライブ動画には対応していません。すべての Bambu モデルで can_snapshot は True として報告されます。X1 で ffmpeg がインストールされていない場合、試行時には失敗を黙って無視せず、モデルに応じた明確なエラーが表示されます。
有料プラン(kiln3d.com/pricing)では、すべてのデザインに対する Git、製品テンプレート、組み立てマニュアル、フリートワークフロー、SSO + SCIM、ERP ウェブフック、長期監査ログが追加されます。
Kiln を選ぶ理由
- 1 つのコントロールプレーンで、あらゆるプリンターに対応 — OctoPrint、Moonraker、Creality、Bambu Lab、Prusa Link、Elegoo、Serial と互換性があります。混在するフリートを 1 か所から管理できます。
- プリンターがなくても大丈夫 — Craftcloud の 150 以上の製造サービスにジョブを委託し、Kiln を通じて見積もりと注文ができます。
- AI ネイティブ — AI エージェント向けに構築された 902 個の MCP 機能と 246 個の CLI コマンドを備えています。API を後付けしたウェブ UI ではありません。
- 説明するだけでプリント — 自然言語から実物を作るパイプライン:テキストまたはスケッチ → AI 生成 → 検証 → スライス → プリント。
- あらゆるものを装飾 — QR コード、写真、ロゴ、テキスト、SVG、手続き型テクスチャ(タイガーストライプ、大理石、迷彩、木目、ハニカム)を、1 つのコマンドであらゆるモデルにエンボス加工またはデボス加工できます。
- マニュアル付き — 複数パーツのプリントでは、部品表、アイソメトリック図による手順ごとのレンダリング、嵌合矢印、一時停止して確認する検証ポイントを含む、印刷可能な PDF 組み立てマニュアルを生成できます。(Business)
- 最初からやり直さずに再開 — プリントがキャンセルされたり失敗したりしましたか?対応する FDM プリンターなら、停止した正確なレイヤーから再開できます。フィラメントを無駄にしません。(Pro)
- プリント中に変更 — ライブプリントに装飾を追加したり、機能を追加したり、素材を切り替えたりできます。問題が発生した場合はアトミックに元に戻せます。(Pro)
- スマートな素材ルーティング — 38 種類の素材と、69 ブランド・製品ラインのブランド別フィラメントプロファイルに対応しています(ブランドごとの調整機能は Kiln Pro の一部です)。プリンターの対応能力を考慮した、用途に基づく推奨機能を備えています。
- プリントの失敗を黙って見過ごしません — プリンターをまたいだ学習、自動的な失敗復旧、クローズドループの AI 生成フィードバック(失敗したプリントをもとに、以後の生成を自動で改善)、すべてのジョブに対するプリフライト安全チェックを備えています。
- 失敗が見込まれるプリントを早期に停止 — ビルドプレートに収まらない、またはホットエンドで溶かせない素材を使っている場合、フィラメントが無駄になる前に検出します。可能な場合は収まるように向きを変え、1 つのコマンドで上書きできます。Pro では、実際に使用可能な領域、最もきれいな分割方法、または切り替えるべき素材が表示されます。
- 検索 → スライス → プリント — MyMiniFactory と Cults3D から 3D モデルを検索してダウンロードし(検索のみ)、PrusaSlicer、OrcaSlicer、または BambuStudio で自動スライスしてプリントできます。すべて 1 回のエージェントとの会話で完了します。
- 大規模運用にも対応する安全性 — 対応するプリンターごとに名前付きの安全プロファイルを用意し、G-code 検証、ヒーター監視機能、改ざん防止監査ログを備えています。Enterprise では、保存時の G-code 暗号化と鍵のローテーション、ロック可能なプロファイル、RBAC、SSO、フリートの拠点グループ化、プロジェクトごとのコスト追跡が追加されます。PostgreSQL HA にも対応します。
対応プリンター
| バックエンド | ステータス | プリンター |
|---|---|---|
| OctoPrint | 安定版 | OctoPrint に接続できるすべてのプリンター(Prusa、Ender、カスタム機など)に対応 |
| Moonraker | 安定版 | Klipper ベースのプリンター(Voron、Ratrig など) |
| Creality | Moonraker に接続できる場合は安定版 | SPARKX i7、K1/K1 Max/K1C/K1 SE、K2/K2 Pro/K2 Plus/K2 SE、Creality Hi、Ender-3 V4/V3 KE、Ender-5 Max、CR-10 SE はローカル Moonraker 経由で対応します。古い Marlin 搭載の Creality プリンターでは、serial または octoprint を使用します。 |
| Bambu | 安定版 | Bambu Lab X1C、X1E、P1S、P1P、P2S、A1、A1 Mini、A2L、H2S、H2D、H2D Pro、H2C、X2D(LAN MQTT 経由) |
| Prusa Link | 安定版 | Prusa MK4、XL、Mini+(ローカル REST API — タイプ:prusalink) |
| Elegoo | 安定版 | Centauri Carbon(LAN WebSocket/SDCP 経由)。Neptune 4 / OrangeStorm Giga は Moonraker を使用します。 |
| Duet / RepRapFirmware | ベータ版 — 実機での検証はまだ行われていません | Duet Web Control が使用するものと同じ HTTP インターフェースを介した、Duet 2 および Duet 3 コントローラーボード。RepRapFirmware 2 と 3 の両方に対応しています。最初にカタログへ登録された機種は Vision Miner 22 IDEX v4 です。タイプ:duet。 |
| USB 直接接続 | 安定版 | USB 経由で接続する、Marlin ベースのすべてのプリンター(Ender 3、Prusa MK3、CR-10 など)。OctoPrint や Klipper は不要で、USB ケーブルだけで使えます。タイプ:serial。 |
Kiln には、15 ブランドの70機種に対応した調整済みプロファイルが含まれています — Creality、Bambu Lab、QIDI、Elegoo、Prusa Research、Sovol、Voron、AON3D、Artillery、AnkerMake、FlashForge、INTAMSYS、RatRig、SparkX、Vision Miner。検索可能な全機種一覧はこちら →
アーキテクチャ
graph TD
A["🤖 AI Agent<br/><sub>Claude · GPT · Custom</sub>"]
A -->|"CLI or MCP"| B["⚙️ Kiln<br/><sub>CLI + MCP Server</sub>"]
B --> C["🖨️ Your Printers"]
B --> F["🏭 Fulfillment"]
B --> D["🛒 Marketplaces"]
B --> V["📐 Designs (versioned)<br/><sub>Pro+</sub>"]
C --> E1["OctoPrint"]
C --> E2["Moonraker"]
C --> E3["Creality"]
C --> E4["Bambu"]
C --> E5["Prusa Link"]
C --> E6["Elegoo"]
F --> F1["Craftcloud"]
D --> I["MyMiniFactory"]
D --> J["Cults3D"]
V --> V1["Branches"]
V --> V2["Signed Releases"]
V --> V3["Cloud Sync"]
style A fill:#1a1a2e,stroke:#e94560,color:#fff
style B fill:#16213e,stroke:#0f3460,color:#fff
style C fill:#0f3460,stroke:#e94560,color:#fff
style F fill:#0f3460,stroke:#27ae60,color:#fff
style D fill:#0f3460,stroke:#533483,color:#fff
style V fill:#0f3460,stroke:#f59e42,color:#fff
style E1 fill:#2d2d44,stroke:#e94560,color:#fff
style E2 fill:#2d2d44,stroke:#e94560,color:#fff
style E3 fill:#2d2d44,stroke:#e94560,color:#fff
style E4 fill:#2d2d44,stroke:#e94560,color:#fff
style E5 fill:#2d2d44,stroke:#e94560,color:#fff
style F1 fill:#2d2d44,stroke:#27ae60,color:#fff
style I fill:#2d2d44,stroke:#533483,color:#fff
style J fill:#2d2d44,stroke:#533483,color:#fff
style V1 fill:#2d2d44,stroke:#f59e42,color:#fff
style V2 fill:#2d2d44,stroke:#f59e42,color:#fff
style V3 fill:#2d2d44,stroke:#f59e42,color:#fff
エージェントは Craftcloud のフルフィルメントを通じてジョブを外部委託でき、MyMiniFactory と Cults3D でモデルを検索することもできます(検索のみ)。デザインストア自体もバージョン管理されています。無料の Kiln アカウントでは、ブランチとデバイス間のクラウド同期が、Pro 以上では署名付きリリースのあるすべてのデザインで利用できます。これらはシステムの中核機能であり、補助的なデータベースではありません。
3D のための Git
プリント部品もコードと同じようにバージョンを重ねていきますが、最終的にはたいてい bracket_final_v2_REAL.stl のような名前になってしまいます。Kiln はすべてのバージョンを保存するため、思い切ったアイデアを試しつつ、実際にプリントできたバージョンを残せます。エージェントには普通の言葉で指示できます:「ブランチで壁厚を4 mmにしてみて、3 mmのものは残しておいて」
- ブランチと元に戻す操作。 ブランチで思い切ったアイデアを試せます。作業中のバージョンは変更されず、どのステップも元に戻せます。
- 変更点の確認。 2つのバージョンを並べて比較したり、間をドラッグして切り替えたりして、各変更で材料がどれだけ増減したかを確認できます。
- プリント履歴。 すべてのプリントは、使用したバージョンに紐づけて記録されるため、それぞれの結果を後から確認できます。
- マージ。 最もうまくプリントできた変更をメインデザインに反映できます。Kiln は可能な変更をマージし、残りについては確認を求めます。
- 署名付きリリース。 出荷するバージョンに署名して、後から変更されていないことを証明できます。
パーツ上をドラッグすると、すべてのプランで2つのバージョンを同時に確認できます。
| プラン | 利用できる機能 |
|---|---|
| Free | すべてのバージョンをお使いのコンピューターに保存し、差分表示とロールバックを利用できます。無料の Kiln アカウントでは、アカウントに同期される、保存したデザインのブランチ、マージ、チェリーピック、元に戻す操作を利用できます |
| Pro | すべてのデザインで上記の機能に加え、パーツ上への変更の描画、ピン留めコメント、プルリクエスト、署名付きリリース、バージョン管理された装飾とフィーチャー、デザインの来歴を利用できます |
| Business | 承認ゲート、チームレビュー、組織、チーム |
| Enterprise | 指名承認者による承認、本番リリース前のステップアップ認証、監査ログのエクスポート、SSO、アクセスレビュー |
ツール
Kiln MCP サーバー(kiln serve)は、エージェントに 895 個のツールを公開し、プロンプトとリソースを含めると、MCP の機能は合計 902 個になります。ここですべてを列挙する代わりに、エージェントは get_skill_manifest と ToolSearch 形式の検索を使って、最新のカタログを参照します。印刷が実際に行われる順に、代表的な項目をいくつか紹介します。
- design_session
- Kiln と作成したいものについて話し、依頼内容に合ったデザインを受け取ります
- あらゆるものづくりの入口です。目標、形状、プレビュー、反復。無料で無制限、すべてのプランで利用できます
- compile_scad
- OpenSCAD コードを印刷可能な STL にコンパイルします。デザインセッションを支える、API キー不要の方法です
- API キーも外部サービスも不要です。エージェントが形状を作成し、Kiln がローカルでコンパイルします
- generate_model
- 外部 AI プロバイダーを通じて、テキストプロンプトから 3D モデルを生成します
- 任意の機能で、ご自身のキーを用意しない限り無効です(Meshy、Tripo3D、Stability、Gemini)
- search_all_models
- 接続済みの 3D モデルマーケットプレイスを一度に検索します
- MyMiniFactory と Cults3D に対応しています。マーケットプレイスが対応している場合はダウンロードもできます
- import_step_file
- STEP(.step/.stp)CAD ファイルをインポートし、Kiln のメッシュパイプライン用に変換します
- analyze_printability
- メッシュの印刷適性を全面的に分析します。オーバーハング、薄壁、反りのリスク、ビルドプレートへの収まりを確認します
- auto_orient_model
- サポート材が最も少なく、最も強く印刷できる向きを見つけます
- repair_mesh
- メッシュの欠陥を修復します。穴、縮退面、丸め誤差によるノイズ状の継ぎ目です
- AI ジェネレーターや粗いスキャンで作成したモデルを直すときによく使います
- split_mesh_to_fit
- ビルドプレートより大きい一体モデルを、印刷後に組み立てられるパーツに分割します
- recommend_material
- 用途に応じて、理由やトレードオフとともに材料を提案します
- decorate_surface
- 画像、テキスト、QR コード、パターンをモデル表面にエンボスまたはデボスとして配置します
- slice_model
- PrusaSlicer、OrcaSlicer、または BambuStudio を使って、モデル(STL/3MF/STEP)を G-code にスライスします
- show_on_stage
- すでにお持ちのファイル(モデル、または印刷直前のスライス済みファイル)を、作り直したり再スライスしたりせずに、Kiln のインタラクティブな 3D ステージに表示します
- estimate_print_cost_from_mesh
- プリンターを使う前に、材料費、重量、印刷時間を見積もります
- preflight_check
- 印刷前の安全確認を行います。プリンターの状態、温度、ファイルの有効性、ベッドとのクリアランスを確認します
- start_print
- 接続済みのマシンで印刷を開始します
- monitor_print
- 印刷状況を一度に確認します。進捗、温度、残り時間、コスト、プリンターにカメラがある場合はカメラのスナップショットも表示します
- emergency_stop
- 実行中の印刷をただちに停止します
- purge_filament
- ノズルを加熱して短い長さのフィラメントを押し出します。詰まりを確認するテストです。スプール交換用の
load_filamentとunload_filamentもあります - プリンターが実際に報告できる内容を伝えます。マシンが流量信号を報告しない場合は、成功したと主張せず、その旨を知らせます
- パージ先を必ず伝えます。お使いのモデルで Kiln が把握している場合は、マシン本体のパージシュートに排出します(Kiln サインインとペアリングされたプリンターでは Kiln のホストサービスを通じて提供され、無料で、オフラインでも動作するようマシンに保存されます)。それ以外の場合は、理由とともにその場で排出します。座標を推測することはありません
- ノズルを加熱して短い長さのフィラメントを押し出します。詰まりを確認するテストです。スプール交換用の
- wipe_nozzle
- プリンター本体のワイプパッドでノズル先端を清掃します(Kiln サインインとペアリングされたプリンターでは Kiln のホストサービスを通じて提供され、無料で、オフラインでも動作するようマシンに保存されます)。Kiln がパッドの位置を把握していないモデルでは実行を拒否し、代わりに何を使うべきかを伝えます
- マシンでまだ実行したことのない動作は、ステップごとに実行します。
plan_onlyはすべての動作を説明し、何も送信しません。step=Nは動作を一つ送信し、何を有効なままにしたかを伝え、最後のステップまで冷却を保留します。ベッドを押したり横切ったりするワイプでは、呼び出しのたびにplate_clearが必要です。これは人が入力する言葉であり、推測されることはありません。モデルのワイプが実機でまだ実行されていない場合、Kiln はその旨を伝え、ステップごとにのみ実行します
- home_axes
- Kiln から Home ボタンを実行します。Kiln が対応しているモデルではそのモデル固有のホーミングルーチンを使い(Kiln サインインとペアリングされたプリンターでは Kiln のホストサービスを通じて提供され、無料で、オフラインでも動作するようマシンに保存されます)、それ以外ではファームウェア固有のルーチンを使います。どちらも安全でない場合は拒否し、画面上のジョグ操作を案内します
- 初回はステップごとに実行します。
plan_onlyは動作を始める前にすべての動作を説明し、step=Nは動作を一つ送信して、何を有効なままにしたかを伝えます
- park_head
- ヘッドをモデル固有のベッド外の位置に移動して、その位置に留めます。Z 軸には触れず、加熱もしません
- plate_status
- Kiln が把握しているビルドプレート上の状態を示します。パーツを残した印刷とその経過時間、またはクリアな状態を表示します。クリアを示すのは、人による申告(
kiln plate clear、または Home と Park でのplate_clear)か、プリンターのカメラによる確認(look_at_plate)のみです。何もせずにクリアと判断することはありません - Home、Park、スライス、印刷開始は、記録されたパーツを避けて動作しようとします。拒否する場合、プリンターにカメラがあればプレートを表示するため、古い記録を鵜呑みにせず確認できます
- Kiln が把握しているビルドプレート上の状態を示します。パーツを残した印刷とその経過時間、またはクリアな状態を表示します。クリアを示すのは、人による申告(
- diagnose_print_failure_live
- プリンターのリアルタイム状態とモデル固有の形状をもとに、失敗しつつある印刷を診断します
- retry_print_with_fix
- 前回の印刷で問題が起きた原因を診断し、修正を適用して再スライスし、印刷します
- resume_interrupted_print (Pro)
- 対応するあらゆる FDM プリンターで、一度の呼び出しで中断した印刷を再開します
- save_design_version
- パラメトリックデザインの新しいバージョンを保存し、うまくいったバージョンに戻れるようにします
- 直線的な履歴は無料です。無料の Kiln アカウントに保存したデザインと Pro のすべてのデザインでは、分岐とマージも無料です。署名付きリリースは Pro です
- export_step
- 完成したデザインを実際の STEP CAD ファイルとしてエクスポートします。機械加工業者が開いて測定できる、解析的な B-rep です
- fleet_status (Business)
- フリート内のすべてのプリンターのリアルタイム状態を確認します。状態、温度、接続状況を表示します
- fulfillment_quote
- Craftcloud のネットワークから製造見積もりを取得します。プリンターを所有せずに印刷できます この範囲を超えるカタログでは、フリートのオーケストレーション、印刷失敗の予測、デザインのバージョン管理、組み立てマニュアル、プリンターごとのキャリブレーションを扱っています。上位プランの詳細は kiln3d.com/pricingをご覧ください。サブシステム別にまとめたツールカタログの全容は、**プロジェクトドキュメント**に掲載されています。あなたがエージェントなら、kiln3d.com/agentsでは同じ内容を二人称で説明しており、拒否される前に知っておくべき事項も含まれています。
MCP リソース(エージェント向けの読み取り専用コンテキスト)
| リソース URI | 説明 |
|---|---|
kiln://status | システム全体のスナップショット(プリンター、キュー、イベント) |
kiln://printers | アイドル状態のプリンターを含むフリート一覧 |
kiln://printers/{name} | 特定のプリンターの詳細なステータス |
kiln://queue | ジョブキューの概要と最近のジョブ |
kiln://queue/{job_id} | 特定のジョブの詳細 |
kiln://events | 最近のイベント(直近50件) |
機能
検索 → ダウンロード → 印刷。 Kiln は search_all_models を使い、1回の呼び出しで MyMiniFactory と Cults3D(検索のみ)を検索し、対応している場合はダウンロードして、そのままプリンターにアップロードします。これは、人手を介さずにデザインから印刷までを完結させるワークフローです。(Thingiverse もサポートされていますが、2026年2月に MyMiniFactory が買収して以降は非推奨です。MMF の利用を推奨します。) マーケットプレイスへのアクセスには無料の API キー(KILN_MMF_API_KEY、KILN_CULTS3D_USERNAME + KILN_CULTS3D_API_KEY)を使用します。
AI モデルの生成。 任意のプロバイダーのキーを設定すれば、すぐに利用できます。KILN_MESHY_API_KEY、KILN_TRIPO3D_API_KEY、KILN_STABILITY_API_KEY、KILN_GEMINI_API_KEY を設定するか、キー不要のローカル OpenSCAD を使用してください。生成されたメッシュは印刷前に、印刷可能性(多様体、三角形の数、バウンディングボックス)が自動検証されます。kiln generate はデフォルトで3方向のプレビューをレンダリングします。
スライス。 PrusaSlicer、OrcaSlicer、BambuStudio をラップし、ヘッドレスでのスライスに対応します。PATH 上、macOS のアプリバンドル、または KILN_SLICER_PATH で指定された、インストール済みのスライサーを自動検出します。STL、3MF、STEP、OBJ、AMF に対応し、素材に応じた温度設定とスマートサポートを備えています。
フルフィルメント(プリンター不要)。 Craftcloud のネットワーク経由で、見積もり、住所の検証、確認、注文、追跡を行えます。また、自社のプリンターと併用して、需要超過への対応や特殊素材の印刷にも利用できます。注文は Kiln のホスト型サービスを通じて処理されるため、プロバイダーの認証情報はサーバー側で管理され、利用者が設定した支出上限も適用されます。
装飾とテクスチャ。 QR コード、写真、ロゴ、テキスト、SVG をモデルの任意の面にエンボスまたはデボス加工できます。また、1回のツール呼び出しで、プロシージャルテクスチャ(虎の縞模様、大理石、迷彩、木目、ハニカム)を適用できます。
料金
ローカルでの印刷は永久に無料です。ステータス確認、ファイル管理、スライス、フリート制御、自分のプリンターでの印刷に料金はかかりません。Kiln は、外部の製造サービスを通じた注文に対して5%のオーケストレーション手数料を請求します(注文ごとに最低 $0.25、最高 $200。Pro アカウントは暦月ごとに最初の 3 件の注文が無料。Business と Enterprise では手数料なし)。手数料はすべての見積もりに明示されます。外部委託の注文量に、どのプランでも上限はありません。
| プラン | 料金 | 主な内容 |
|---|---|---|
| Free | $0 | ローカル印刷、スライス、マーケットプレイス検索、安全プロファイルは無制限。プリンター 1 台、デザインインテリジェンス、線形デザイン履歴、無料アカウントに保存したデザインの Git-for-3D ブランチ機能。 |
| Pro | $49/月 | すべてのデザインで Git-for-3D ブランチ機能、署名付きリリース、製品テンプレート、プロシージャルテクスチャ、印刷中の変更、印刷再開、失敗からの復旧、ノズル摩耗の追跡、個人向けクラウド同期。 |
| Business | $199/月 | 商用利用、プリンター 3 台+シート 3 席、フリート管理、プリンター間学習、QR コード生成、組み立てマニュアル、チームのプルリクエスト、承認ゲート、Webhook。 |
| Enterprise | お問い合わせください | 大規模フリート、SSO/SCIM、RBAC、監査証跡、保存時の G-code 暗号化、ホワイトラベルのマニュアル、99.9% SLA、オンプレミス/VPC。 |
創業記念オファー:創業者向け枠がある限り、永続的に半額です。Pro は $24.50/月または $234/年、Business は $99.50/月または $954/年です。学生は 12 か月間、半額になります。学生価格の詳細と申し込み方法:kiln3d.com/pricing。
比較の詳細は kiln3d.com/pricing をご覧ください。すでにサブスクリプションをご利用の場合は、kiln signin を実行して、このマシンをプランに登録してください。プロバイダー経由の注文では、プロバイダーが引き続き販売者となり、Kiln はオーケストレーションのインフラストラクチャとして機能します。
安全性
Kiln は、物理マシンを制御するための安全性を最優先したインフラストラクチャです。
- 印刷前チェックにより、印刷のたびにプリンターの状態、温度、ファイルを検証します
- G-code の検証により、危険なコマンド(ファームウェアのリセット、安全でない温度など)をブロックします
- 温度制限により、安全な上限(ホットエンドは 300 °C、ベッドは 130 °C)を適用します
- 印刷の前に人が実行を承認します。AI アプリの承認ダイアログで承認するか、Kiln が画面に表示するコードを入力するか、ターミナルで承認します。ただし、確認を求めない設定を選んだ場合は除きます。その設定は一時的(最長 1 日)、自分で名前を付けたプリンターで常に有効(自分のターミナル、または二要素認証を使う Kiln アカウントページで設定)、または自分で自動印刷をオンにする方法があります。印刷の停止、一時停止、監視では、承認は不要です
- 破壊的な操作(キャンセル、raw G-code)には確認が必要です
- 任意の認証により、複数ユーザー環境向けにスコープベースの API キーを利用できます
- 構造化エラーにより、エージェントは問題が発生したときに必ず把握できます
パッケージ
このモノレポには 2 つのパッケージがあります。
| パッケージ | 説明 | エントリーポイント |
|---|---|---|
| kiln | マルチプリンター制御用の CLI+MCP サーバー(OctoPrint、Moonraker、Creality、Bambu、Prusa Link、Elegoo、Direct USB) | kiln または python -m kiln |
| octoprint-cli | OctoPrint のみの環境向けの軽量なスタンドアロン CLI | octoprint-cli |
開発
# Create a virtualenv first (required on modern Ubuntu/Debian/WSL)
python3 -m venv .venv && source .venv/bin/activate
pip install -e "./kiln[dev]"
pip install -e "./octoprint-cli[dev]"
cd kiln && python3 -m pytest tests/ -v
cd ../octoprint-cli && python3 -m pytest tests/ -v
Docker で実行する
docker compose up は、自分のプリンターに接続する Kiln MCP サーバーをセルフホストします。まず KILN_PRINTER_TYPE/KILN_PRINTER_HOST/KILN_PRINTER_API_KEY を設定してください。これは個人向けのセルフホスト用クイックスタートであり、ホスト型の api.kiln3d.com サービスを支えるインフラストラクチャとは関係ありません。セットアップ不要の方法をご希望ですか?kiln3d.com でホスト版をご利用いただけます。
設定リファレンス(認証、Webhook、検出、プラグイン)
認証(任意)
MCP ツール向けの API キー認証は任意で、デフォルトでは無効です。スコープは read、write、admin です。読み取り専用ツールでは認証は必要ありません。
export KILN_AUTH_ENABLED=1
export KILN_AUTH_KEY=your_secret_key
export KILN_MCP_AUTH_TOKEN=your_secret_key # clients provide their key here
Webhook
リアルタイムのイベント通知を受け取る HTTP エンドポイントを登録します。
register_webhook(url="https://example.com/hook", events=["job.completed", "print.failed"])
シークレットを指定すると、ペイロードは HMAC-SHA256 で署名されます。リダイレクトはデフォルトでブロックされます(KILN_WEBHOOK_ALLOW_REDIRECTS=0)。有効にした場合、各リダイレクト先で SSRF 検証が行われ、HTTPS から HTTP へのダウングレードはブロックされます。
プリンターの検出
kiln discover # mDNS/Bonjour + HTTP subnet probing
OctoPrint、Moonraker/Creality、Bambu、Elegoo、Prusa Link のプリンターを検出します。検出結果がない場合は、kiln auth を使って IP アドレスを指定し、直接登録してください。
サードパーティープラグイン
エントリーポイントプラグインは、本番環境ではデフォルトで拒否されます(KILN_PLUGIN_POLICY=strict)。特定のプラグインを許可するには KILN_ALLOWED_PLUGINS=my_plugin,other_plugin を指定するか、一時的な移行互換性のために KILN_PLUGIN_POLICY=permissive を設定してください。
モジュール(コントリビューター向け)
| モジュール | 説明 | |---|---| | `server.py` | ツール、リソース、サブシステムの接続を備えた MCP サーバー | | `printers/` | プリンターアダプターの抽象化(OctoPrint、Moonraker、Creality、Bambu、Prusa Link、Elegoo) | | `marketplaces/` | モデルマーケットプレイスのアダプター(MyMiniFactory、Cults3D、Thingiverse、メタデータのみのソース) | | `slicer.py` | スライサー統合(PrusaSlicer、OrcaSlicer、BambuStudio)と自動検出 | | `registry.py` | 複数プリンター管理用のフリートレジストリ | | `queue.py` | ステータス追跡機能を備えた優先度付きジョブキュー | | `scheduler.py` | 履歴に基づくスマートなルーティング機能を備えたバックグラウンドジョブのディスパッチャー | | `events.py` | 履歴機能を備えた Pub/Sub イベントバス | | `persistence.py` | ジョブ、イベント、設定用の SQLite ストレージ | | `webhooks.py` | HMAC 署名付きのイベント駆動型 Webhook 配信 | | `auth.py` | スコープベースのアクセス制御を備えたオプションの API キー認証 | | `discovery.py` | ネットワーク上のプリンター検出(mDNS + HTTP プローブ) | | `generation/` | テキストからモデルを生成するプロバイダー(Meshy、Tripo3D、Stability AI、Gemini Deep Think、OpenSCAD)。自動検出、メッシュ検証、印刷適性分析に対応 | | `consumer.py` | プリンターを持たないユーザー向けのコンシューマーワークフロー(住所確認、素材の推奨、所要時間/価格の見積もり、オンボーディング) | | `cost_estimator.py` | G-code 分析に基づく印刷コストの見積もり | | `materials.py` | 複数素材とスプールの追跡 | | `material_inventory.py` | フリート全体の素材在庫と割り当ての追跡 | | `bed_leveling.py` | 自動ベッドレベリングのトリガーシステム | | `streaming.py` | MJPEG ウェブカメラストリーミングプロキシ | | `cloud_sync.py` | プリンター設定とジョブ履歴のクラウド同期 | | `plugin_loader.py` | 内部ツールプラグインの検出と登録 | | `plugins/` | プラグインローダーによって読み込まれる、用途を絞った MCP ツールモジュール | | `gcode.py` | プリンターごとの制限に対応した G-code 安全性バリデーター | | `gcode_interceptor.py` | ルールベースの G-code 傍受と安全性を高める書き換え | | `safety_profiles.py` | 対応するすべてのモデルを対象とした、プリンターごとの安全制限(温度、送り速度、流量)。各プリンターのプロファイルは Kiln のカタログから提供され、その他の機種には同梱の汎用基準が適用されます | | `slicer_profiles.py` | 同梱のスライサープロファイル(プリンターごとの .ini ファイルを自動生成) | | `printer_intelligence.py` | プリンターの一覧と仕様書:各機種の制限、素材ごとの温度、動作特性を記載。仕様書は各プリンターについて Kiln のカタログから提供されます(厳選された特記事項、キャリブレーション手順、失敗モードは Kiln Pro に含まれます) | | `pipelines.py` | 検証済みの印刷パイプライン(quick_print、calibrate、benchmark) | | `assembly.py` | 複数パーツの組み立て検証と手動計画のサポート | | `design_versions.py` | ローカルのデザイン履歴、バージョン記録、差分、ロールバックの基本機能 | | `mesh_validation_pipeline.py` | 複数の検証ゲートを備えた印刷適性検証パイプライン | | `model_visualizer.py` | ローカルでのモデルプレビュー描画 | | `tool_schema.py` | OpenAI の関数呼び出しスキーマコンバーター(MCP → OpenAI 形式) | | `tool_tiers.py` | モデルの機能との適合に使うツール階層の定義(essential/standard/full) | | `agent_loop.py` | OpenAI 互換 API(OpenRouter、直接接続など)に対応する汎用エージェントループ | | `openrouter.py` | モデルカタログと階層の自動検出を備えた OpenRouter 統合 | | `data/` | 同梱の JSON データベース(安全プロファイル、スライサープロファイル、プリンター情報) | | `heater_watchdog.py` | アイドル状態のヒーターを自動冷却するウォッチドッグ | | `wallets.py` | 暗号資産ウォレット設定(寄付と手数料用の Solana/Ethereum) | | `pro_tool_manifest.json` | kiln-pro のツール検出と REST プロキシスタブ用の公開マニフェスト | | `decoration_quota.py` | 無料プランの装飾割り当て追跡とプラン解決フック | | `cli/` | 246 個のコマンドと JSON 出力に対応した Click CLI | kiln-pro([kiln3d.com](https://kiln3d.com/?utm_source=github&utm_medium=readme))は、有料プラン向けのRESTサービング、請求、ライセンス、SSO、RBAC、Gコード暗号化、稼働時間レポート、チーム管理、プロジェクトコストのワークフローを追加し、公開版のKilnを拡張します。公開版のKilnが公開するのは、これらの機能のインターフェース/プロキシ部分のみです。非公開の実装はkiln-proにあります。ドキュメント
| ドキュメント | 説明 |
|---|---|
| プロジェクトドキュメント | 完全なリファレンス(CLI、MCP ツール、アダプター、設定) |
ブランド素材
ロゴファイルは docs/assets/ にあります。すべてベクターSVG形式で、任意のサイズに拡大縮小できます。
| ファイル | 用途 |
|---|---|
kiln-banner-1280x640.svg / kiln-banner-1280x640-light.svg | GitHub/ソーシャルメディアのバナー(ダーク/ライト配色) |
kiln-logo-dark.svg / kiln-logo-light.svg | メインマーク+ワードマーク(ダーク/ライト背景) |
kiln-horizontal-dark.svg / kiln-horizontal-light.svg | 横型ロックアップ(ダーク/ライト背景) |
kiln-logo-dark-notext.svg | マークのみ(ダーク背景) |
kiln-favicon-256.svg | ファビコン/アプリアイコン |
kiln-logo-transparent.svg / kiln-logo-transparent-dark.svg | 透明背景(ダーク/ライトUI向け) |
kiln-mark-1024.svg | 正方形のマークタイル — プロフィール画像、アプリタイル(1024×1024) |
kiln-x-header-1500x500.svg | ソーシャルメディアのヘッダー(1500×500) |
wallpapers/kiln-wallpaper-iphone-*.svg | iPhone用壁紙 |
wallpapers/kiln-wallpaper-macbook-*.svg | MacBook用壁紙 |
上記のすべてのファイルは、1つのジオメトリから生成されているため、マークはすべて同一です。描き直さず、ベクターを拡大縮小してください。
開発を支援する
Kilnは無料のオープンソースソフトウェアです。役に立った場合は、チップをご検討ください。
- Solana:
kiln3d.sol - Ethereum:
kiln3d.eth
位置付け
メッセージングに関する明確化(2026年2月24日): 表現の曖昧さをなくし、既存の意図に沿うよう文言を明確化しました。戦略の変更はありません。Kilnは、製造ワークフロー向けのオーケストレーションおよびエージェントインフラストラクチャです。Kilnは、ファーストパーティの分散型製造マーケットプレイス/ネットワークを運営していません。Kilnは、連携可能になったサードパーティプロバイダーや外部プロバイダー/ネットワークアダプターと統合します。
対象外: ファーストパーティの分散型製造マーケットプレイス/ネットワークの運営、パートナーのサプライサイドネットワークの置き換え、プロバイダーのマーケットプレイスを統合するのではなく自社で所有すること、プロバイダー経由の製造注文における販売者としての記録上の役割を担うこと。
ライセンス
Kilnは**Hadron Labs Inc.**のプロジェクトです。
AGPL-3.0ライセンス — コピーレフトのオープンソースです。プロプライエタリな利用が必要な企業向けに、商用ライセンスも利用できます。
貢献することで、貢献者ライセンス契約に同意したものとみなされます。
Smitheryにも掲載されています。
商標
OctoPrintは登録商標です。その他の製品名および会社名は各所有者の商標です。Kilnはそれらと提携しておらず、推奨も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。