CadKit MCP Server
Officialby cadkit-dev
README.md
# CadKit
CadKit lets your AI design 3D-printed parts for you. You say what you
need ("a holder for my screwdrivers", "an enclosure for this board with
USB-C"); your AI builds the part in CadKit, CadKit checks it, and you
get files that are ready for your slicer.
You do not model anything yourself. CadKit gives the AI a toolbox: it
builds every part from code ([build123d](https://github.com/gumyr/build123d)),
runs a catalog of checks on every part and every pair of parts (wall
thickness, overhangs, fits, collisions, tipping over, …), names the exact
spot of every problem, and keeps a list of the questions only you can
answer.
What CadKit is good at is **the print that fits the first time on your
own printer**:
- **Measured fits.** You print one small calibration piece per printer,
nozzle and filament and measure it; every fit is then computed from your
numbers. Without them a fit is not released — CadKit stops instead of
guessing.
- **A stop list.** Dimensions the AI could only guess (your phone, the nut
you bought) block the handoff until you confirm or measure them.
- **A cross-check on the slicer's result.** CadKit slices the plate and
reads the G-code: supports inside a fit, thin features the slicer
dropped, cooling per layer, first-layer gaps.
- **Insert pauses** for nuts and magnets, checked against the layer the
pause lands on.
- **A finished Bambu Studio project** with plates, two materials and your
presets, next to plain 3MF, STL and STEP.
What CadKit is not: a CAD program with a drawing surface, a slicer, or a
sandbox (see [Trust](#trust-cadkit-runs-a-projects-code)).
## What you need
- **Windows 10 or 11, 64-bit.** This release runs on Windows only. Linux
and macOS are not supported yet.
- An AI app that speaks MCP: Claude Desktop or Claude Code, ChatGPT /
Codex, Cursor or VS Code.
- A 3D printer and its slicer. The slicer cross-check works with Bambu
Studio and OrcaSlicer (PrusaSlicer with an exported `config.ini`).
Without a slicer CadKit still checks the model and hands off STL, STEP
and 3MF; grams, print time and supports then come from your slicer
alone.
- **Digital calipers.** CadKit asks you to print a small test piece once
and measure three dimensions — without them you can design and look at
a part, but its fits are not released for printing.
## Install
**The installer.** Download `CadKit-<version>-Setup.exe` from the
[Releases page](https://github.com/cadkit-dev/cadkit/releases) and run it. It
installs for your user only, to `%LOCALAPPDATA%\Programs\CadKit`, adds
CadKit to the Start menu and needs no administrator rights. Every release
lists the SHA-256 of its files; compare it before you run the installer
(`Get-FileHash .\CadKit-<version>-Setup.exe` in PowerShell). An installed
CadKit updates itself from the Releases page and accepts only updates
that carry the project's signature.
The installer is not yet signed with a Windows code-signing certificate.
Windows SmartScreen therefore shows "Windows protected your PC" with an
unknown publisher on the first start; after you have compared the SHA-256,
choose *More info* → *Run anyway*. Updates do not depend on this: they are
checked against the project's own Ed25519 signature before anything is
installed.
**From source.** With Python 3.12 and [uv](https://docs.astral.sh/uv/):
```
git clone https://github.com/cadkit-dev/cadkit.git cadkit
cd cadkit
uv sync --extra mcp
uv run cadkit doctor
```
`cadkit doctor` tells you what works on your machine and what is missing
(slicer, slicer profiles, OpenSCAD — all optional). A source install is
updated with `git pull` and `uv sync`, not by CadKit itself.
To remove an installed CadKit: *Settings → Apps → Installed apps → CadKit →
Uninstall*. Your projects and settings stay where they are (see below).
## First project
1. **Connect your AI.** Open **CadKit** from the Start menu (from source:
`uv run python -m cadkit.programm`), go to the **Connect AI** tab, add
CadKit to your AI app, then restart the AI app. Without the window:
point your AI app's MCP configuration at `cadkit mcp`.
2. **Ask your AI.** Start a new chat and paste the starter prompt from
the start page, for example:
> Read the CadKit guide first and ask me for my printer, nozzle and
> material. Then build me a simple phone stand for my desk: phone up
> to 80 mm wide and 10 mm thick, leaning back at about 60°. Create the
> project first-try (if it is already there from an earlier try,
> continue in it), check it until it is green or only questions for
> me are left, and show me the result.
3. **Watch it.** The **Studio** tab shows the model live and reloads
after every check. You can point at a spot in the 3D view and leave a
note; ask your AI to look at your selection.
You can also drive CadKit yourself: `cadkit new <folder>`, `cadkit check`,
`cadkit calibrate`, `cadkit handoff`; `cadkit --help` lists everything and
`cadkit guide` prints the guide your AI reads.
## What to expect
- **The first check usually ends with questions** — the stop list. The AI
asks you to confirm dimensions it could only guess (your phone, your
screwdriver handles) and to **calibrate** once.
- **Calibrate once per printer, nozzle and material.** Print the small
calibration block, measure three values with calipers and give them to
the AI. Saved with `--shared`, every later project for that printer,
nozzle and material uses them.
- **Green means no check is red — not that the part works.** CadKit does
not know your load cases or the real size of things you bought. Print
a test piece for anything that has to fit.
- **Yellow means not checked.** A check that could not run, or data that
is missing, never counts as passed.
- **At the end, the handoff** gives you STL, STEP and 3MF files with the
parts in print orientation, plus the parameters and the open questions.
## Printers and slicers
CadKit's checks on the model do not depend on a printer brand. The parts
around the slicer do:
- Slicer profiles are taken from the Bambu Studio or OrcaSlicer installed
on your machine; CadKit ships none. For a printer it cannot resolve, the
project's `profile/README.md` says which presets to export.
- The finished Bambu Studio project, the preset tools and the chamber
climate profile are made for Bambu Lab printers.
- **Experimental, tried on the Bambu Lab X2D only:** reading the printer
over the LAN (`cadkit printer`: start stages, filament match, recording,
camera frames), writing K values, and the surface texture generator
(`cadkit surface`). Expect rough edges on other machines.
## Trust: CadKit runs a project's code
A CadKit project is Python code. `check`, `build`, `audit` and `handoff`
run that code with **your** user rights — there is no sandbox, only a
memory and time limit.
- Projects your AI creates in CadKit are trusted automatically. An AI you
connected to CadKit can therefore run code as you; connect only an AI
you would also let use your terminal.
- A project you downloaded or copied runs only after **you** trust it:
**Trust this project** on its page in the CadKit window, or
`cadkit trust <folder>` typed at a terminal. Until then every run ends
with "not trusted yet". Your AI cannot do this for you.
- Trust only projects whose source you trust, the same as any program.
More in [SECURITY.md](SECURITY.md).
## Examples
`beispiele/gridfinity_bin` and `beispiele/pcb_enclosure` are small
projects to look at. Copy one into your projects folder, trust it
(`cadkit trust <folder>`), then run `cadkit check` in it.
## Where your files are
| What | Where |
|---|---|
| Your projects | `%USERPROFILE%\cadkit-projekte` (change it on the **Setup** tab) |
| Settings, trust list, calibration cache | `%LOCALAPPDATA%\cadkit2` |
| The installed program | `%LOCALAPPDATA%\Programs\CadKit` |
CadKit runs on your computer. It has no telemetry and does not upload your
projects or files. What your AI reads through CadKit (the guide, reports,
images of the model) goes to your AI provider, as everything else in that
chat. The network connections CadKit itself makes are listed in
[SECURITY.md](SECURITY.md).
## What CadKit generates is yours
Everything you design with CadKit belongs to you: your models, your
project code, the reports, dashboards, drawings and packages. You may
print, share, sell and publish them under any terms you like — MakerWorld
and similar platforms included. The project templates and the 3D viewer
that CadKit embeds in a dashboard are licensed under MIT-0 for exactly
that reason (see [NOTICE](NOTICE)).
## Feedback and problems
There is no support promise: CadKit is a one-person project. Bug reports
and ideas are welcome as
[issues](https://github.com/cadkit-dev/cadkit/issues). The project folder
(zipped, or `cadkit support-bundle`) helps a lot. Copy this into the issue
and fill it in:
```
Build: (cadkit --version, or the About/Update tab)
AI app and model: (e.g. Claude Desktop, Sonnet)
Printer, nozzle, filament, slicer:
What I asked the AI:
What I expected:
What happened: (exit code, the red or stop row, an error text)
Last step that worked:
```
For a print problem, also a photo and what you measured.
Security problems never go into a public issue — see
[SECURITY.md](SECURITY.md).
Worth telling: where the AI got stuck, where it asked you something it
should have known, where a green part did not fit or print, and where the
CadKit window confused you. How to contribute code:
[CONTRIBUTING.md](CONTRIBUTING.md).
## Supporting CadKit
CadKit is free. If it saved you a few failed prints and you want to give
something back: [GitHub Sponsors](https://github.com/sponsors/cadkit-dev).
Sponsoring buys nothing — no features, no support — it just helps.
## Licence
CadKit is free software under the
[GNU General Public License, version 3 or later](LICENSE). The project
templates and the viewer embedded in generated output are MIT-0; details
and attributions are in [NOTICE](NOTICE). The Windows installer bundles
open-source components; their licences are in `THIRD-PARTY-NOTICES.txt`
next to the installer and in the program folder.