关于 Kiln
Kiln 是面向 3D 打印工作流的开源 MCP 服务,让 AI Agent 从设计和切片到排队打印、监控打印机。它支持多种打印机及 OctoPrint、Moonraker/Klipper、PrusaLink 和 USB 连接。
主要功能
- 01生成并设计 3D 模型
- 02切片并提交打印任务
- 03监控打印机与摄像头
- 04打印机发现和配置
- 05保存设计版本并比较
- 06支持多种打印机连接方式
适用场景
- 01根据描述设计并打印物件
- 02向已配置的打印机提交切片任务
- 03监控打印进度并处理故障
- 04比较设计版本并恢复改动
MCP 相关
通过 MCP 向 AI Agent 提供设计、切片、打印机管理和打印监控工具;服务端提供的工具可经 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 Agent(ChatGPT、Claude Desktop、Claude Code、Codex、Cursor、Gemini、Grok 或任何自定义 MCP 客户端)端到端地驱动真正的 3D 打印机,包括 Bambu Lab、Creality、Prusa、Elegoo、Voron、Sovol、AnkerMake、Artillery、FlashForge、QIDI、RatRig 和 SparkX。它兼容 OctoPrint、Moonraker/Klipper、PrusaLink 和 Direct USB。
在一次对话中,Agent 就能设计零件、切片、将其排入合适打印机的队列、监控摄像头、从故障中恢复,并完成打印。无需人工介入。
你是 AI Agent,正在阅读本文吗? kiln3d.com/agents 是为你而非运行你的用户编写的:涵盖安装、MCP 配置、从设计到打印的工作流程,以及 Kiln 会拒绝做什么及其原因。
pip install kiln3d
“做一个带有我家狗狗 Ash 照片的杯垫”——从头到尾,只需一句话。
观看演示 →
**面向 3D 的 Git 会保留每个版本。**创建设计分支来尝试大胆想法,用数据对比任意两个版本,合并成功打印的版本,还能撤销任何操作。了解其工作原理 →
Kiln 的开发过程公开透明。如果它让你的打印更有趣,或者只是帮你省去了麻烦,在仓库点个 ⭐,就能让更多创客发现它。
快速开始
在使用 Claude Desktop?一键安装 Kiln。 下载 kiln.mcpb,然后双击 — Claude Desktop 会安装 Kiln 并完成接入(仅适用于 Claude Desktop:以下第 1、2 步是 Codex 和其他所有 AI 应用的连接方式),所以你不需要执行这两步。还有两件事需要你来做:安装 OpenSCAD,以及接受 Kiln 的条款 — 运行命令后会显示条款并要求你输入同意,因此这一步必须由你而不是 AI 来完成:uvx --from kiln3d kiln accept-terms。安装包和该命令都通过 uv 运行 — 它免费,该链接中提供了各个平台的一行安装命令。如果 Claude Desktop 提示服务启动失败,说明缺少 uv:安装后重启即可。更新会随扩展一同提供,而不是通过 kiln self-update 更新。
在使用 ChatGPT、Claude、Gemini、Grok 或 Cursor?无需安装。 在应用中通过地址 https://api.kiln3d.com/mcp 添加 Kiln 并登录:它会设计部件、检查是否可打印,并在聊天中以 3D 形式显示,只要应用支持显示即可。各应用的页面会准确说明其中展示的内容:ChatGPT、Claude、Codex、Cursor、Gemini、Grok。如需使用自己的打印机,请在旁边的电脑上完成以下三步。
其他所有用户 — 三步即可。然后让 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 甚至可以为你完成整个设置 — 单提示词版本请见 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 的 Agent 中。登录前可使用免费套餐。
3. 提出需求 — 在 Agent 中粘贴类似下面的一句话。剩下的交给 Kiln:
给我做一个印有我家狗狗照片的杯垫
这就是完整的顺畅流程。AI 会负责设计、切片和打印 — 你无需接触 CLI。按操作系统分类的指南(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> 可在每条命令中指定目标打印机。完整命令参考请见 项目文档。
连接特定 Agent(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 Code 使用 ~/.kiln/config.yaml 中的打印机凭据(通过 kiln setup 或 kiln auth 设置)。如果已经配置了打印机,则无需环境变量。
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 适用于任何支持 OpenAI 兼容函数调用的模型,不仅限于 Claude:
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 个工具)。所有 895 个工具都可通过 MCP 使用 kiln serve 访问。
平台和打印机设置说明(Linux/WSL 2、仅以太网、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。完全支持仅以太网连接的打印机。
**可选工具:**使用 PrusaSlicer OrcaSlicer 或 BambuStudio,将 STL 切片为 G-code(brew install --cask prusaslicer);使用 OpenSCAD 在本地生成文本到 3D 的模型——安装当前构建版本(brew install --cask openscad@snapshot);设置 KILN_GEMINI_API_KEY 以启用 Gemini 生成几何模型。
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 直接连接(与仅以太网设置相同)。
仅以太网打印机(无 Wi-Fi)
Kiln 在以太网和 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;对于没有安装 ffmpeg 的 X1,尝试时会显示清晰且针对该型号的错误,而不会静默失败。
付费套餐(kiln3d.com/pricing)还提供每个设计的 Git 版本管理、产品模板、装配手册、设备集群工作流、SSO + SCIM、ERP Webhook 和长期审计日志。
为什么选择 Kiln?
- 一个控制平面,适用任何打印机 — 兼容 OctoPrint、Moonraker、Creality、Bambu Lab、Prusa Link、Elegoo、Serial。可在一个地方管理混合设备集群。
- 没有打印机?没问题 — 通过 Kiln 将打印任务外包给 Craftcloud 的 150 多家制造服务商,并在其中获取报价和下单。
- AI 原生 — 为 AI Agent 打造,具备 902 项 MCP 功能和 246 条 CLI 命令。不是在 Web UI 上硬加 API。
- 描述需求,即可打印 — 从自然语言到实物的完整流程:文本或草图 → AI 生成 → 验证 → 切片 → 打印。
- 为任何模型添加装饰 — 只需一条命令,即可在任何模型上压印或凹刻 QR 码、照片、徽标、文本、SVG 和程序化纹理(虎纹、大理石、迷彩、木纹、蜂窝)。
- 附带手册 — 多部件打印可生成可打印的 PDF 装配手册,包含物料清单、等轴测分步渲染图、配合箭头以及暂停并检查的验证关卡。(Business)
- 继续打印,无需重来 — 打印任务取消或失败?可在任何受支持的 FDM 打印机上从停止的确切层继续打印。不浪费耗材。(Pro)
- 打印过程中修改 — 在打印进行中添加装饰、追加特征或更换材料;出现问题时可原子化回退。(Pro)
- 智能材料匹配 — 支持 38 种材料,以及涵盖 69 个品牌和系列的品牌耗材配置文件(每个品牌的微调功能包含在 Kiln Pro 中)。根据用途提供建议,并考虑打印机的能力。
- 打印故障不会悄无声息 — 跨打印机学习、自动故障恢复、闭环 AI 生成反馈(打印失败会自动改进后续生成结果),以及每项任务的打印前安全检查。
- 提前阻止注定失败的打印 — 模型太大,无法放入成型平台?或者热端无法熔化所用材料?系统会在浪费耗材前发现问题;条件允许时会旋转模型以适应平台,也可通过一条命令覆盖限制。Pro 会显示解决方法:真实可用区域、最合适的拆分方式,或应更换的材料。
- 搜索 → 切片 → 打印 — 从 MyMiniFactory 和 Cults3D 搜索并下载 3D 模型(仅支持搜索),使用 PrusaSlicer、OrcaSlicer 或 BambuStudio 自动切片并打印——全部通过一次 Agent 对话完成。
- 大规模安全保障 — 为每台受支持的打印机配置命名安全配置文件,并提供 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 — type:prusalink) |
| Elegoo | 稳定 | Centauri Carbon(通过 LAN WebSocket/SDCP)。Neptune 4 / OrangeStorm Giga 使用 Moonraker。 |
| Duet / RepRapFirmware | Beta — 尚未通过实体硬件验证 | Duet 2 和 Duet 3 控制器板,使用与 Duet Web Control 相同的 HTTP 接口。支持 RepRapFirmware 2 和 3。Vision Miner 22 IDEX v4 是首个编入目录的机器。Type:duet。 |
| Direct USB | 稳定 | 任何通过 USB 连接的基于 Marlin 的打印机(Ender 3、Prusa MK3、CR-10 等)。无需 OctoPrint 或 Klipper — 只需一根 USB 线缆。Type: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
Agent 还可以通过 Craftcloud 履约服务外包打印任务,并在 MyMiniFactory 和 Cults3D 上搜索模型(仅搜索)。设计商店本身采用版本管理 — 免费 Kiln 账户会在设计上保留分支和跨设备云同步;Pro 及更高版本则会为每个带有签名发布版本的设计提供这些功能。这些都是系统的一等输出,而非旁置数据库。
3D 版 Git
打印部件也会像代码一样经历多个版本,最后往往变成 bracket_final_v2_REAL.stl。Kiln 会为你保留每个版本,因此你可以尝试大胆的想法,同时保留实际打印成功的版本。你的 Agent 只需用日常语言提出要求:“在一个分支上试试 4 mm 壁厚,并保留 3 mm 的版本。”
- 分支与撤销。 在分支上尝试大胆的想法。工作版本保持不变,任何步骤都可以撤销。
- 查看变更。 并排比较两个版本,或在两者之间拖动查看差异,并查看每项变更增加或减少了多少材料。
- 打印记录。 每次打印都会归档到对应的版本下,因此你可以查阅每次打印的结果。
- 合并。 将打印效果最佳的变更带回主设计。Kiln 会合并可自动处理的部分,并询问你如何处理其余部分。
- 签名发布版本。 为要发布的版本签名,日后即可证明它未被更改。
拖动部件即可同时查看两个版本,所有套餐均可使用。
| 套餐 | 内容 |
|---|---|
| 免费版 | 将每个版本保存在你的电脑上,并提供差异比较和回滚功能。使用免费 Kiln 账户后:你保留的设计支持分支、合并、拣选和撤销,并同步到该账户 |
| Pro | 所有设计均包含上述功能,另有在部件上绘制变更、固定评论、拉取请求、签名发布版本、带版本管理的装饰和特征,以及设计溯源 |
| Business | 审批关卡、团队审核、组织和团队 |
| Enterprise | 指定审批人签核、生产发布前的强化登录验证、审计日志导出、SSO、访问权限审核 |
工具
Kiln MCP 服务(kiln serve)向 Agent 暴露 ** 895 个工具**,以及提示词和资源,共 ** 902 项 MCP 能力**。这里不一一列出,Agent 可通过 get_skill_manifest 和 ToolSearch 风格的发现机制浏览实时目录。以下是其中一部分,按实际打印顺序排列:
- design_session
- 与 Kiln 交流你要制作的东西,并获取符合你需求的设计
- 制作任何东西的入口:目标、几何形状、预览、迭代。免费、无限制,适用于所有套餐
- compile_scad
- 将 OpenSCAD 代码编译为可打印的 STL — 设计会话底层无需密钥的路径
- 无需 API 密钥或外部服务:Agent 编写几何形状,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
- 在模型表面添加任意图像、文本、二维码或图案,形成浮雕或凹雕
- 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 中执行归位:Kiln 掌握你所用型号的专属归位程序时使用该程序(对于已与 Kiln 登录账号配对的打印机,此信息通过 Kiln 托管服务提供,免费,并保存在你的机器上,因此离线时仍可使用);其他情况下使用固件自身的程序;如果两种方式都不安全,则拒绝操作并指出屏幕上的点动控制项
- 首次运行时分步执行:
plan_only会在任何部件移动前描述每个动作;step=N会发送一个动作,并说明留下了什么待执行状态
- park_head
- 将打印头移至该型号专属的打印平台外位置并停在那里;绝不接触 Z 轴,绝不加热
- plate_status
- Kiln 记录的打印平台状态:留下部件的打印任务及其完成时间,或平台已清空 — 用户明确说明(
kiln plate clear,或在归位和停放操作中使用plate_clear),或通过打印机摄像头查看(look_at_plate);不会自行将平台标记为已清空 - 归位、停放、切片和开始打印时,如果会经过已记录的部件,都会拒绝操作;打印机配有摄像头时,拒绝信息会显示平台画面,以便核实旧记录,而不是直接信任它
- 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。完整工具目录按子系统分组,见 Project Docs。如果你就是这个 Agent,kiln3d.com/agents 会用第二人称介绍相同内容,包括你在遇到限制前值得了解的拒绝情形。
MCP 资源(面向 Agent 的只读上下文)
| 资源 URI | 描述 |
|---|---|
kiln://status | 系统级快照(打印机、队列、事件) |
kiln://printers | 设备群列表及空闲打印机 |
kiln://printers/{name} | 特定打印机的详细状态 |
kiln://queue | 作业队列摘要和近期作业 |
kiln://queue/{job_id} | 特定作业的详细信息 |
kiln://events | 近期事件(最近 50 条) |
功能
搜索 → 下载 → 打印。 Kiln 通过一次 search_all_models 调用即可搜索 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 浮雕或阴刻到任意模型表面,也可通过一次工具调用应用程序化纹理(虎纹、大理石、迷彩、木纹、蜂窝)。
定价
所有本地打印永久免费——状态查看、文件管理、切片、设备群管理以及使用自己的打印机进行打印都不收费。通过外部制造服务下单时,Kiln 会收取 5% 的协调服务费(每笔订单最低 $0.25 / 最高 $200;Pro 账户每个自然月的前 3 笔订单免费;Business 和 Enterprise 不收取费用),并在每份报价中透明列明。所有套餐均不限制外包订单量。
| 套餐 | 价格 | 主要权益 |
|---|---|---|
| Free | $0 | 无限制本地打印、切片、市场搜索、安全配置文件、一台打印机、设计智能、线性设计历史,以及对保存在免费账户中的设计进行 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 显示在屏幕上的代码,或在终端确认;除非你选择不再询问:在一段时间内(最多一天)、始终允许指定打印机打印(在你自己的终端上,或通过双重验证在 Kiln 账户页面设置),或者自行开启自动打印;停止、暂停和监控打印则无需确认
- 破坏性操作需要确认(取消、原始 G-code)
- 可选身份验证,通过基于权限范围的 API 密钥支持多用户配置
- 结构化错误确保 Agent 始终能获知失败情况
软件包
此单仓库包含两个软件包:
| 软件包 | 说明 | 入口点 |
|---|---|---|
| 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
Webhooks
注册 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` | 带历史记录的发布/订阅事件总线 | | `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、直连等)的通用 Agent 循环 | | `openrouter.py` | OpenRouter 集成,包含模型目录和自动层级检测 | | `data/` | 随附的 JSON 数据库(安全配置文件、切片器配置文件、打印机智能数据) | | `heater_watchdog.py` | 针对闲置加热器的自动冷却看门狗 | | `wallets.py` | 加密货币钱包配置(用于捐赠和费用的 Solana/Ethereum) | | `pro_tool_manifest.json` | 用于发现 kiln-pro 工具和 REST 代理存根的公开清单 | | `decoration_quota.py` | 免费层级装饰配额跟踪和层级解析钩子 | | `cli/` | Click 命令行,包含 246 个命令并支持 JSON 输出 | kiln-pro([kiln3d.com](https://kiln3d.com/?utm_source=github&utm_medium=readme))在公开版 Kiln 的基础上,扩展了付费层级的 REST 服务、账单、许可、SSO、RBAC、G-code 加密、运行时间报告、团队管理和项目成本工作流。公开版 Kiln 仅提供这些功能的接口/代理层;私有实现则保留在 kiln-pro 中。文档
| 文档 | 说明 |
|---|---|
| 项目文档 | 完整参考资料(CLI、MCP 工具、适配器、配置) |
品牌素材
Logo 文件位于 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 壁纸 |
以上所有文件均由同一套几何图形生成,因此标志在所有文件中完全一致。请勿重新绘制 — 直接缩放矢量图即可。
支持开发
Kiln 是免费开源软件。如果你觉得它有用,可以考虑打赏:
- Solana:
kiln3d.sol - Ethereum:
kiln3d.eth
定位
信息说明(2026 年 2 月 24 日): 我们澄清了措辞,以消除歧义并与既有意图保持一致;战略没有变化。Kiln 是面向制造工作流的编排和 Agent 基础设施。Kiln 不运营自有的去中心化制造市场/网络。随着集成的逐步推出,Kiln 会接入第三方服务提供商以及外部服务提供商/网络适配器。
非目标: 运营自有的去中心化制造市场/网络;取代合作伙伴的供应侧网络;自建服务提供商市场而非与之集成;作为由服务提供商承接的制造订单的记录商家。
许可证
Kiln 是 Hadron Labs Inc. 的项目。
AGPL-3.0 许可证 — 采用 Copyleft 的开源许可证。需要专有用途的公司可使用商业许可。
参与贡献即表示你同意贡献者许可协议。
也收录于 Smithery。
商标
OctoPrint 是注册商标。其他产品和公司名称均为其各自所有者的商标;Kiln 与它们没有关联,也未获得它们的认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。