API ВЕГА
English

MCP-сервер с открытым исходным кодом для 3D-печати.

От идеи до готового предмета — со всеми промежуточными версиями.

Kiln позволяет AI-агентам (ChatGPT, Claude Desktop, Claude Code, Codex, Cursor, Gemini, Grok, Hermes Agent, OpenClaw или любому пользовательскому MCP-клиенту) управлять настоящими 3D-принтерами на всех этапах — Bambu Lab, Creality, Prusa, Elegoo, Voron, Sovol, AnkerMake, Artillery, FlashForge, QIDI, RatRig и SparkX. Сервер совместим с OctoPrint, Moonraker/Klipper, PrusaLink и прямым подключением по USB.

В рамках одного диалога агент может спроектировать деталь, подготовить её к печати, поставить задание в очередь на нужном принтере, следить за камерой, устранять сбои и отправить готовый результат. Без участия человека.

Вы читаете это как AI-агент? Страница kiln3d.com/agents предназначена для вас, а не для человека, который вас запускает: на ней описаны установка, настройка MCP, цикл от проектирования до печати, а также случаи, в которых Kiln откажется выполнять запрос, и причины отказа.

pip install kiln3d

«Подставка под стакан с фотографией моей собаки Эш» — от начала до конца, по одной фразе.

Смотреть демонстрацию →

Git для 3D сохраняет каждую версию. Создайте ветку проекта, чтобы проверить смелую идею, сравните любые две версии по числовым параметрам, объедините ту, что удалось напечатать, и отмените любые изменения. Посмотреть, как это работает →

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 или Hermes Agent? Устанавливать ничего не нужно. Добавьте Kiln в приложении по адресу https://api.kiln3d.com/mcp и войдите в аккаунт. Для Hermes Agent достаточно одной команды в терминале — она приведена на странице приложения. После этого Kiln спроектирует деталь, проверит возможность печати и покажет её в 3D прямо в чате, если приложение поддерживает такой просмотр. На странице каждого приложения указано, что именно проверено: ChatGPT, Claude, Codex, Cursor, Gemini, Grok, Hermes Agent. Чтобы управлять собственным принтером, выполните три шага ниже на компьютере, расположенном рядом с ним.

Пользуетесь OpenClaw? Попросите его установить Kiln из ClawHub — он настроит Kiln на компьютере, где запущен: инструкция.

Для всех остальных — три шага. Затем попросите 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. Сервер работает на бесплатном тарифе, пока вы не войдёте в аккаунт.

3. Запрос — отправьте агенту, например, такую фразу. Остальное сделает Kiln:

Сделай подставку под стакан с фотографией моей собаки

Вот и весь простой сценарий. AI спроектирует модель, подготовит её к печати и запустит печать — вам не придётся пользоваться CLI. Инструкции для Windows, WSL 2 и Linux доступны на странице kiln3d.com/install.

Совет

Команда kiln doctor проверит всю конфигурацию и точно укажет, что нужно исправить. Команда kiln self-update обновит Kiln без переустановки после выхода новой версии.

Хотите управлять принтером самостоятельно? (обзор 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 указывает принтер, к которому относится команда. Полный список команд приведён в документации проекта.

Подключение конкретного агента (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, только Ethernet, Bambu)

Требования в зависимости от типа принтера

Принтер--typeЧто потребуется
Prusa MK4/XL/Mini+prusalinkIP-адрес и API key (Settings › Network › PrusaLink на LCD)
OctoPrint (любой принтер)octoprintURL OctoPrint и API key (User Settings › Application Keys)
Klipper/MoonrakermoonrakerURL Moonraker (обычно http://:7125)
Creality K1/K2/Hi/Ender V4/V3 KEcrealityIP-адрес и printer_model (например, creality_k1_max); сервер проверяет локальные порты Moonraker
Bambu LabbambuIP-адрес, серийный номер и код доступа к LAN — все данные отображаются на экране принтера; для запуска и управления печатью включите LAN Only Mode и Developer Mode
Elegoo (SDCP)elegooТолько IP-адрес — аутентификация не нужна. Для Neptune 4 / OrangeStorm Giga используйте moonraker.
Duet / RepRapFirmwareduetТолько IP-адрес и, если задан, пароль устройства (M551 в config.g).
Прямое подключение по USB (Marlin)usbТолько USB-кабель — сеть не нужна. Ender 3, Prusa MK3, CR-10 и любые принтеры на Marlin/RepRap.

Kiln требуется только доступ к IP-адресу принтера в локальной сети. Принтеры, подключённые только по Ethernet, полностью поддерживаются.

Дополнительные инструменты: 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-адресу, как и при использовании принтеров только с Ethernet.

Принтеры, подключённые только по Ethernet (без Wi-Fi)

Kiln одинаково работает по Ethernet и Wi-Fi: он взаимодействует с API принтера по его IP-адресу в локальной сети. Убедитесь, что конечная точка принтера отвечает, а затем добавьте принтер по IP-адресу:

/api/version # OctoPrint curl http://:7125/server/info # Moonraker / Creality (локальный Moonraker) curl -H "X-Api-Key: YOUR_KEY" http:///api/v1/status # Prusa Link

Для Bambu используется MQTT — проверьте доступность порта 8883: nc -zv 8883

kiln auth --name my-printer --host http:// --type prusalink --api-key YOUR_KEY --printer-model MK4">

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.

TLS и веб-камера Bambu

При первом подключении 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 для 3D-проектов, шаблоны продуктов, руководства по сборке, инструменты для работы с парком принтеров, SSO + SCIM, вебхуки ERP и долгосрочное хранение журналов аудита.

Почему Kiln?

  • Единая система управления для любых принтеров — поддерживаются OctoPrint, Moonraker, Creality, Bambu Lab, Prusa Link, Elegoo и Serial. Управляйте смешанным парком принтеров из одного интерфейса.

  • Нет принтера? Не проблема — передавайте заказы более чем 150 производственным сервисам Craftcloud, получайте расчёт стоимости и оформляйте заказы через Kiln.

  • Создан для AI — 902 возможности MCP и 246 команд CLI для AI-агентов. Это не веб-интерфейс, к которому просто добавили API.

  • Опишите объект — и напечатайте его — полный цикл от естественно-языкового описания или наброска до физического объекта: описание или эскиз → создание с помощью AI → проверка → нарезка → печать.

  • Добавляйте декор на любые модели — наносите QR-коды, фотографии, логотипы, текст, SVG и процедурные текстуры (тигровые полосы, мрамор, камуфляж, древесный рисунок, соты), создавая рельеф или углубления одной командой.

  • Руководства в комплекте — для многоэлементных изделий можно создавать пригодные для печати PDF-руководства по сборке с ведомостью материалов, изометрическими изображениями этапов, стрелками совмещения деталей и контрольными паузами для проверки. (Business)

  • Продолжайте печать, а не начинайте заново — отменённую или прерванную печать можно возобновить с точного слоя остановки на любом поддерживаемом FDM-принтере. Без потери филамента. (Pro)

  • Изменяйте модель во время печати — добавляйте декор, новые элементы или меняйте материалы прямо во время печати. Если что-то пойдёт не так, изменения можно атомарно отменить. (Pro)

  • Интеллектуальный подбор материалов — 38 материалов и профили филамента для 69 брендов и линеек (настройка для отдельных брендов входит в Kiln Pro). Рекомендации учитывают задачу и возможности принтера.

  • Сбои печати не остаются незамеченными — обучение на данных разных принтеров, автоматическое восстановление после сбоев, обратная связь для AI-генерации с замкнутым циклом (после неудачной печати система автоматически улучшает будущие варианты), предварительная проверка безопасности для каждого задания.

  • Проблемная печать останавливается заранее — если модель не помещается на платформу или хотэнд не может расплавить выбранный материал, система обнаружит это до потери филамента. Когда возможно, модель будет повёрнута для размещения на платформе; проверку можно обойти одной командой. В Pro также предлагается решение: фактически доступная область печати, оптимальный вариант разделения модели или подходящий материал для замены.

  • Поиск → нарезка → печать — ищите и скачивайте 3D-модели с MyMiniFactory и Cults3D (только поиск), автоматически нарезайте их с помощью PrusaSlicer, OrcaSlicer или BambuStudio и запускайте печать — всё в рамках одного диалога с агентом.

  • Безопасность при масштабировании — для каждого поддерживаемого принтера предусмотрен отдельный профиль безопасности, проверка G-code, контроль нагревателя и защищённые от подмены журналы аудита. В Enterprise дополнительно доступны шифрование G-code в состоянии покоя с ротацией ключей, блокируемые профили, RBAC, SSO, группировка принтеров по площадкам, учёт затрат по проектам и PostgreSQL HA.

Поддерживаемые принтеры

BackendСтатусПринтеры
OctoPrintСтабильная версияСовместим с любым принтером, подключённым через OctoPrint (Prusa, Ender, пользовательские модели)
MoonrakerСтабильная версияПринтеры на базе Klipper (Voron, Ratrig и другие)
CrealityСтабильная версия при доступности MoonrakerSPARKX 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. На старых принтерах Creality с Marlin используйте 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 2 и Duet 3 через тот же HTTP-интерфейс, который использует Duet Web Control. Поддерживаются RepRapFirmware 2 и 3. Vision Miner 22 IDEX v4 — первая модель в каталоге. Тип: duet.
Прямое подключение по USBСтабильная версияЛюбой принтер на базе Marlin с подключением по USB (Ender 3, Prusa MK3, CR-10 и другие). OctoPrint или Klipper не нужны — достаточно USB-кабеля. Тип: serial.

В Kiln включены настроенные профили для 70 моделей от 15 брендов: 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 и выше. Всё это — основные результаты работы системы, а не отдельная база данных.

Git для 3D

Печатная деталь проходит через версии так же, как код, а её файлы обычно заканчиваются названиями вроде bracket_final_v2_REAL.stl. Kiln сохраняет все версии, чтобы вы могли проверить рискованную идею и оставить ту, которая успешно напечаталась. Достаточно попросить агента обычными словами: «попробуй стенки толщиной 4 мм в отдельной ветке, а вариант с толщиной 3 мм оставь».

  • Ветвление и отмена изменений. Проверяйте рискованные идеи в отдельной ветке: рабочая версия останется нетронутой, а любой шаг можно отменить.

  • Просмотр изменений. Сравнивайте две версии рядом или перемещайте разделитель между ними. Kiln также показывает, сколько материала добавлено или удалено в результате изменений.

  • История печати. Каждая печать привязана к версии, на основе которой она выполнена. Так вы сможете посмотреть, как прошла каждая попытка.

  • Слияние. Перенесите в основной проект изменения из версии, которая лучше всего напечаталась. Kiln объединит те изменения, которые сможет, а по остальным запросит ваше решение.

  • Подписанные релизы. Подпишите версию, которую выпускаете, и позднее подтвердите, что она не менялась.

    На любом тарифе можно перетаскивать разделитель, чтобы одновременно видеть две версии детали.

ТарифВозможности
FreeВсе версии сохраняются на вашем компьютере; доступны сравнение изменений и откат. С бесплатным аккаунтом Kiln можно создавать ветки, выполнять слияние, cherry-pick и отменять изменения в сохранённых проектах, синхронизируя их с аккаунтом
ProВсе возможности тарифа Free для каждого проекта, а также визуализация изменений на детали, закреплённые комментарии, pull request, подписанные релизы, версии декора и элементов, а также сведения о происхождении проекта
BusinessЭтапы согласования, командная проверка, организации и команды
EnterpriseСогласование назначенными ответственными, дополнительное подтверждение входа перед производственными релизами, экспорт журнала аудита, SSO и проверка прав доступа

Узнайте, как работает Git для 3D →

Инструменты

MCP-сервер Kiln (kiln serve) предоставляет агентам ** 895 инструментов**, а вместе с промптами и ресурсами — всего 902 возможности MCP. Перечислять их все здесь нецелесообразно: агенты могут просматривать актуальный каталог с помощью get_skill_manifest и находить инструменты через поиск в стиле ToolSearch. Ниже приведена выборка инструментов в порядке, соответствующем реальному процессу печати:

  • design_session

    • Обсудите с Kiln, что вы хотите создать, и получите проект, соответствующий вашему запросу

    • Отправная точка для создания чего угодно: цель, геометрия, предварительный просмотр, итерации. Бесплатно, без ограничений и доступно на всех тарифах

  • compile_scad

    • Компилирует код OpenSCAD в STL-файл, готовый к печати — основной способ работы без ключа в рамках сеанса проектирования

    • API-ключ и внешний сервис не нужны: агент задаёт геометрию, а Kiln компилирует её локально

  • generate_model

    • Создаёт 3D-модель по текстовому описанию с помощью внешнего AI-провайдера

    • Инструмент необязательный и по умолчанию отключён: для работы нужен ваш ключ (Meshy, Tripo3D, Stability, Gemini)

  • search_all_models

    • Ищет модели на подключённых маркетплейсах 3D-моделей за один вызов

    • Поддерживает MyMiniFactory и Cults3D; скачивает модели, если маркетплейс это позволяет

  • import_step_file

    • Импортирует CAD-файл STEP (.step/.stp) и преобразует его для конвейера обработки сеток Kiln

  • analyze_printability

    • Выполняет полный анализ пригодности сетки к печати: проверяет нависающие элементы, тонкие стенки, риск деформации и соответствие размерам стола

  • auto_orient_model

    • Подбирает ориентацию модели, при которой требуется минимум поддержек и обеспечивается максимальная прочность печати

  • repair_mesh

    • Исправляет дефекты сетки: отверстия, вырожденные грани и швы с шумом округления

    • Обычно этот инструмент используют для моделей, созданных AI-генератором или полученных при неточном сканировании

  • split_mesh_to_fit

    • Разрезает слишком крупную для стола цельную модель на детали, которые можно напечатать и затем собрать

  • recommend_material

    • Рекомендует материалы для конкретного применения, объясняя причины выбора и возможные компромиссы

  • decorate_surface

    • Наносит на поверхность модели изображение, текст, QR-код или узор в виде рельефа или гравировки

  • slice_model

    • Подготавливает модель (STL/3MF/STEP) к печати и создаёт G-code с помощью PrusaSlicer, OrcaSlicer или BambuStudio

  • show_on_stage

    • Показывает уже имеющийся файл — модель или файл, подготовленный к печати, — на интерактивной 3D-сцене Kiln, не создавая модель заново и не выполняя повторную подготовку к печати

  • 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

    • Выполняет команду Home из Kiln: использует процедуру возврата в исходное положение, предусмотренную для конкретной модели, если она известна Kiln (данные предоставляются через хостинговый сервис Kiln для принтера, связанного с вашей учётной записью Kiln; услуга бесплатна, а данные сохраняются на принтере, чтобы он продолжал работать без подключения к сети). В остальных случаях используется штатная процедура прошивки. Если ни один из вариантов не безопасен, инструмент откажется от выполнения и укажет на экранные элементы управления перемещением

    • При первом запуске процедура выполняется поэтапно: plan_only описывает каждое движение до начала перемещения; step=N выполняет одно движение и сообщает, в каком состоянии оставлена система

  • park_head

    • Перемещает головку в предусмотренное для конкретной модели положение за пределами стола и оставляет её там. Не касается оси Z и не включает нагрев

  • plate_status

    • Показывает, что Kiln знает о состоянии стола: какая деталь осталась на нём после печати и как давно, либо что стол свободен. Чтобы отметить стол как свободный, нужно подтверждение от человека (kiln plate clear или plate_clear для команд Home и Park) либо проверка по камере принтера (look_at_plate); самостоятельно Kiln не помечает стол как свободный

    • Команды Home, Park, подготовка к печати и запуск печати не выполняются, если по записи на столе осталась деталь. При отказе Kiln показывает изображение стола с камеры, если она есть у принтера, чтобы проверить старую запись, а не полагаться на неё без проверки

  • diagnose_print_failure_live

    • Диагностирует сбой печати по текущему состоянию принтера и геометрии модели

  • retry_print_with_fix

    • Определяет причину последнего сбоя печати, затем повторно подготавливает модель и запускает печать с исправлением

  • resume_interrupted_print (Pro)

    • Возобновляет прерванную печать одним вызовом на любом поддерживаемом FDM-принтере

  • save_design_version

    • Сохраняет новую версию параметрического проекта, чтобы можно было вернуться к рабочему варианту

    • Линейная история версий бесплатна; создание веток и объединение изменений бесплатны для проектов, сохранённых в бесплатной учётной записи Kiln, и для всех проектов с Pro; подписанные релизы доступны в Pro

  • export_step

    • Экспортирует готовый проект в полноценный CAD-файл STEP — аналитическую B-rep-геометрию, которую можно открыть и измерить в мастерской

  • fleet_status (Business)

    • Показывает актуальный статус всех принтеров в парке: состояние, температуры и подключение

  • fulfillment_quote

    • Запрашивает расчёт стоимости производства через сеть Craftcloud — печатать можно, даже если у вас нет собственного принтера

Помимо этой выборки, каталог включает инструменты для управления парком принтеров, прогнозирования сбоев печати, контроля версий проектов, создания инструкций по сборке и калибровки отдельных машин. Возможности расширенных тарифов описаны на странице тарифов. Полный каталог инструментов, сгруппированный по подсистемам, доступен в разделе документации проекта. Если вы — агент, на странице kiln3d.com/agents та же информация изложена от второго лица, включая важные ограничения, с которыми стоит ознакомиться заранее.

Ресурсы MCP (контекст только для чтения)

URI ресурсаОписание
kiln://statusОбщая сводка по системе: принтеры, очередь, события
kiln://printersСписок принтеров парка, включая свободные
kiln://printers/{name}Подробный статус конкретного принтера
kiln://queueСводка по очереди заданий и недавним заданиям
kiln://queue/{job_id}Подробная информация о конкретном задании
kiln://eventsПоследние события (до 50)

Возможности

Поиск → скачивание → печать. Kiln за один вызов выполняет поиск на MyMiniFactory и Cults3D (только поиск), скачивает модели, если это поддерживается, и отправляет их прямо на принтер. Так можно пройти весь путь от выбора модели до печати без участия человека. (Поддержка Thingiverse сохранена, но считается устаревшей с момента приобретения сервиса MyMiniFactory в феврале 2026 года; рекомендуется использовать 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 создаёт предварительный просмотр модели с трёх ракурсов.

Подготовка к печати. Для подготовки моделей без графического интерфейса используются PrusaSlicer, OrcaSlicer и BambuStudio. Kiln автоматически обнаруживает установленные слайсеры в PATH, в пакетах приложений macOS или по пути, заданному в KILN_SLICER_PATH. Поддерживаются STL, 3MF, STEP, OBJ и AMF, а также температуры с учётом материала и интеллектуальная генерация поддержек.

Производство без собственного принтера. Размещайте заказы на печать через сеть Craftcloud: получите расчёт стоимости, проверьте адрес, подтвердите заказ и отслеживайте его выполнение. Также можно использовать эту услугу вместе с собственными принтерами для обработки избыточной нагрузки и работы со специальными материалами. Заказы оформляются через хостинговый сервис Kiln, который хранит учётные данные провайдеров на сервере и обеспечивает соблюдение заданных вами лимитов расходов.

Декорирование и текстуры. Наносите на любую грань модели QR-коды, фотографии, логотипы, текст и SVG-файлы в виде рельефа или гравировки. Также можно одним вызовом инструмента применять процедурные текстуры: полосы тигра, мрамор, камуфляж, древесную текстуру и соты.

Цены

Вся локальная печать бесплатна навсегда: проверка состояния, управление файлами, нарезка моделей, управление парком принтеров и печать на собственных устройствах ничего не стоят. Заказы через внешние сервисы производства Kiln облагает сбором за координацию в размере 5% (минимум $0,25 и максимум $200 за заказ; первые 3 заказа в каждом календарном месяце бесплатны для аккаунтов Pro; для Business и Enterprise сбор не взимается). Сбор прозрачно отображается в каждом расчёте стоимости. Объём заказов на внешнее производство не ограничен ни на одном тарифе.

ТарифЦенаОсновные возможности
Free$0Неограниченная локальная печать, нарезка моделей, поиск по маркетплейсам, профили безопасности, один принтер, интеллектуальные функции для работы с дизайнами, линейная история изменений и ветвление Git-for-3D для дизайнов, сохранённых в бесплатном аккаунте.
Pro$49/moВетвление Git-for-3D для любого дизайна, подписанные релизы, шаблоны продуктов, процедурные текстуры, изменение во время печати, возобновление печати, восстановление после сбоев, отслеживание износа сопла, облачная синхронизация для одного пользователя.
Business$199/moКоммерческое использование, 3 принтера и 3 пользовательских места, управление парком принтеров, обмен опытом между принтерами, создание QR-кодов, инструкции по сборке, pull request для команды, этапы утверждения, вебхуки.
EnterpriseСвяжитесь с намиКрупные парки принтеров, SSO/SCIM, RBAC, журнал аудита, шифрование G-code при хранении, инструкции с фирменным оформлением, SLA 99,9%, локальное развёртывание/VPC.

Предложение для первых пользователей: скидка 50% навсегда, пока есть свободные места: Pro — $24.50/mo или $234/yr, Business — $99.50/mo или $954/yr. Для студентов действует скидка 50% в течение 12 месяцев. Подробности и информация о том, как получить студенческую цену: kiln3d.com/pricing.

Полное сравнение тарифов доступно на kiln3d.com/pricing. Уже оформили подписку? Выполните kiln signin, чтобы подключить этот компьютер к своему тарифу. При заказах через провайдеров продавцом по договору остаётся провайдер; Kiln предоставляет инфраструктуру для координации.

Безопасность

Kiln — инфраструктура для управления физическими устройствами, созданная с приоритетом безопасности:

  • Предварительная проверка состояния принтера, температур и файлов перед каждой печатью

  • Проверка G-code блокирует опасные команды (сброс прошивки, небезопасные температуры)

  • Ограничения температуры задают безопасные максимальные значения (300 °C для хотэнда, 130 °C для стола)

  • Перед каждой печатью человек должен дать разрешение — в диалоговом окне подтверждения вашего AI-приложения, введя код, который Kiln показывает на экране, или в терминале. Подтверждение не требуется, если вы сами отключили запрос: на некоторое время (не более чем на день), для выбранного вами принтера (в собственном терминале или на странице аккаунта Kiln с двухфакторной аутентификацией) либо включив автоматическую печать. Останавливать печать, ставить её на паузу и наблюдать за процессом можно без подтверждения.

  • Для разрушительных операций (отмена, необработанный G-code) требуется подтверждение

  • Необязательная аутентификация с API-ключами, ограниченными по областям доступа, для конфигураций с несколькими пользователями

  • Структурированные ошибки позволяют агентам всегда распознавать сбои

Пакеты

В этом монорепозитории находятся два пакета:

ПакетОписаниеТочка входа
kilnCLI и MCP-сервер для управления несколькими принтерами (OctoPrint, Moonraker, Creality, Bambu, Prusa Link, Elegoo, Direct USB)kiln или python -m kiln
octoprint-cliОтдельный облегчённый CLI для конфигураций только с OctoPrintoctoprint-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 запускает собственный MCP-сервер Kiln, подключённый к вашему принтеру. Сначала задайте KILN_PRINTER_TYPE/KILN_PRINTER_HOST/KILN_PRINTER_API_KEY. Это краткая инструкция для личного самостоятельного развёртывания, не связанная с инфраструктурой размещённого сервиса api.kiln3d.com. Хотите обойтись без настройки? kiln3d.com запустит для вас размещённую версию.

Справочник по настройке (аутентификация, вебхуки, обнаружение, плагины)

Аутентификация (необязательно)

Аутентификация API-ключом для инструментов MCP включена по желанию и по умолчанию отключена. Области доступа: 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

Вебхуки

Зарегистрируйте 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. Если обнаружить устройства не удалось, зарегистрируйте принтер напрямую по IP-адресу с помощью kiln auth.

Сторонние плагины

В производственной среде плагины точек входа по умолчанию запрещены (KILN_PLUGIN_POLICY=strict). Чтобы разрешить отдельные плагины, задайте KILN_ALLOWED_PLUGINS=my_plugin,other_plugin. Для временной совместимости при миграции установите KILN_PLUGIN_POLICY=permissive.

Модули (для участников проекта)

МодульОписание
server.pyMCP-сервер с инструментами, ресурсами и связями между подсистемами
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Доставка событий через webhook с подписью HMAC
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Универсальный цикл агента для любого API, совместимого с OpenAI (OpenRouter, прямое подключение и др.)
openrouter.pyИнтеграция с OpenRouter, включающая каталог моделей и автоматическое определение уровня
data/Встроенные базы данных JSON (профили безопасности, профили слайсеров, сведения о принтерах)
heater_watchdog.pyСистема автоматического охлаждения нагревателей в режиме ожидания
wallets.pyНастройка криптокошельков (Solana/Ethereum для пожертвований и комиссий)
pro_tool_manifest.jsonОбщедоступный манифест для обнаружения инструментов kiln-pro и заглушки REST-прокси
decoration_quota.pyУчёт квот бесплатного уровня для декорирования и хуки определения уровня
cli/CLI на Click с 246 командами и выводом в формате JSON

kiln-pro (kiln3d.com) расширяет общедоступный Kiln: добавляет REST-обслуживание для платных тарифов, выставление счетов, лицензирование, SSO, RBAC, шифрование G-code, отчёты о времени безотказной работы, администрирование команд и сценарии расчёта стоимости проектов. Общедоступная версия 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.svgFavicon / значок приложения
kiln-logo-transparent.svg / kiln-logo-transparent-dark.svgПрозрачный фон (для тёмных / светлых интерфейсов)
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

Позиционирование

Уточнение формулировок (24 февраля 2026 года): Мы уточнили формулировки, чтобы устранить неоднозначность и привести их в соответствие с исходным замыслом; стратегия не изменилась. Kiln — это инфраструктура для оркестрации и работы агентов в производственных процессах. Kiln не управляет собственной децентрализованной торговой площадкой или сетью производителей. По мере появления интеграций Kiln подключается к сторонним провайдерам и внешним адаптерам провайдеров и сетей.

Что не входит в задачи проекта: создание собственной децентрализованной торговой площадки или сети производителей; замена сетей партнёров, объединяющих поставщиков; владение торговыми площадками провайдеров вместо интеграции с ними; выступление в роли продавца, несущего ответственность за проведение заказов на производство, направленных провайдерам.

Лицензия

Kiln — проект Hadron Labs Inc.

Лицензия AGPL-3.0 — открытый исходный код с условием copyleft. Для компаний, которым необходимо использовать ПО в проприетарных проектах, доступно коммерческое лицензирование.

Внося вклад в проект, вы соглашаетесь с условиями лицензионного соглашения участника.

Проект также представлен на Smithery.

Товарные знаки

OctoPrint — зарегистрированный товарный знак. Названия других продуктов и компаний являются товарными знаками соответствующих владельцев; Kiln не связан с ними и не имеет их одобрения.