bambu-cli MCP server
Commit Nov 14, 2026Automates 3D printing workflows by chaining mesh geometry operations with BambuStudio CLI orchestration.
Also known as catesworks/bambu-cli-mcp
- Stars
- 2
- Tools
- 22
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- MIT
What is bambu-cli MCP?
bambu-cli automates 3D printing workflows by chaining mesh geometry operations with BambuStudio CLI orchestration. It exposes 22 tools, such as inspect_bambu_cli, convert_to_3mf, arrange_project.
Summary generated from the project's README
About bambu-cli MCP server
Converting raw 3D mesh files into print-ready manufacturing packages is what this server enables for makers and engineers. By connecting an AI client like Claude Desktop or Claude Code to BambuStudio, users can use natural language to manage complex 3D printing pipelines. The system integrates mesh geometry operations with BambuStudio CLI orchestration to handle everything from initial file inspection to final slicing.
Users can choose between two specialized toolsets or a combined mode. The geometry tools handle tasks like repairing meshes, scaling models, and recursively splitting oversized parts to fit specific build volumes. The BambuStudio tools manage slicing, arranging objects on the build plate, and exporting 3MF projects. This setup requires BambuStudio to be installed on the local machine and uses Node.js to run the server via stdio.
What sets this apart is the ability to chain operations into declarative workflows. For example, a single command can inspect a mesh, scale it, split it into smaller pieces, add dowel connectors for assembly, and then slice the resulting parts for a specific printer like the Bambu X1E.
What you can do with it
- 1Prepare oversized models for printingScale a large STL file and automatically split it into smaller parts that fit within a 256mm build volume.
- 2Automate assembly part creationAdd surface-validated dowel connectors to split mesh seams to ensure parts fit together during assembly.
- 3Validate mesh integrityCheck if a 3D model is watertight and retrieve its dimensions and volume before processing.
Written from the project's README. Every use case is checked against a quote from it.
bambu-cli MCP tools 22
Detected from the READMEinspect_bambu_cliconvert_to_3mfarrange_projectorient_projectslice_projectexport_plate_pngexport_stlsexport_settingsvalidate_projectestimate_printcreate_print_packageinspect_mesh
Show all 22 toolsShow fewer tools
repair_meshscale_meshsplit_meshlay_flatadd_dowel_connectorsgenerate_assembly_manifestmake_printable_large_modelrepair_and_preparesplit_with_connectorslist_available_engines
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecatesworks/bambu-cli-mcp is public and reachablegithub.com/catesworks/bambu-cli-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-06github.com/catesworks/bambu-cli-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model22 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubbambu-cli-mcp
Topics: vercel cli mcp
AI-native 3D printing pipelines via MCP. Turn natural language into print-ready manufacturing packages.
Two MCP servers expose 22 tools that chain mesh geometry operations and BambuStudio CLI orchestration into declarative manufacturing workflows — from STL to sliced, split, connector-equipped 3MF projects.
Documentation | Architecture Decisions | Examples
What it does
"Scale this ramp to 400% and split it for my Bambu X1E"
|
v
inspect_mesh (watertight check, dimensions)
|
repair_mesh (fix normals, merge vertices)
|
scale_mesh (uniform 4x)
|
split_mesh (recursive until all parts fit 256mm)
|
add_dowel_connectors (surface-validated, 12mm dowels)
|
BambuStudio CLI (orient, arrange, export 3MF per part)
|
v
36 print-ready 3MF files + assembly manifest
Quick Start
Prerequisites
- BambuStudio installed
- Node.js >= 20
- pnpm
Install
git clone https://github.com/catesworks/bambu-cli-mcp.git
cd bambu-cli-mcp
pnpm install
pnpm build
Configure your MCP client
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"bambu-cli-mcp": {
"command": "node",
"args": ["/path/to/bambu-cli-mcp/dist/index.js", "--server", "both"]
}
}
}
Claude Code (.claude/settings.json):
{
"mcpServers": {
"bambu-cli-mcp": {
"command": "node",
"args": ["/path/to/bambu-cli-mcp/dist/index.js", "--server", "both"]
}
}
}
The --server flag selects which tools to load:
| Flag | Tools | Use case |
|---|---|---|
bambu |
11 BambuStudio tools | Slicing and export only |
geometry |
11 geometry tools | Mesh processing only |
both |
All 22 tools | Full pipeline |
Tools
BambuStudio Tools (11)
| Tool | Description |
|---|---|
inspect_bambu_cli |
Returns BambuStudio version, path, and available CLI flags |
convert_to_3mf |
Convert STL/OBJ files into a .3mf project |
arrange_project |
Auto-arrange objects on the build plate |
orient_project |
Auto-orient objects for optimal printing |
slice_project |
Slice a project with specified settings |
export_plate_png |
Export PNG preview images of plates |
export_stls |
Export objects as individual STL files |
export_settings |
Export BambuStudio settings to JSON |
validate_project |
Validate a project and report info/warnings |
estimate_print |
Estimate print time and filament usage |
create_print_package |
Full pipeline: convert, arrange, orient, slice, preview |
Geometry Tools (11)
Core:
| Tool | Description |
|---|---|
inspect_mesh |
Bounds, triangle count, volume, watertight status, genus |
repair_mesh |
Fix normals, merge vertices, remove degenerate faces |
scale_mesh |
Uniform scaling by any factor |
split_mesh |
Recursive splitting until all parts fit build volume |
lay_flat |
Orient largest flat face onto build plate |
add_dowel_connectors |
Surface-validated dowel connectors on split seams |
generate_assembly_manifest |
Parts, neighbors, connectors, hardware list |
Workflows:
| Tool | Description |
|---|---|
make_printable_large_model |
inspect -> scale -> repair -> split -> connectors -> manifest |
repair_and_prepare |
inspect -> repair -> lay flat |
split_with_connectors |
split -> connectors -> manifest |
list_available_engines |
Detect available CAD engines |
Examples
Inspect a mesh
{
"tool": "inspect_mesh",
"arguments": { "path": "/models/ramp.stl" }
}
Returns:
{
"bounds": { "min": [-5, -5, 0], "max": [5, 5, 10], "size": [10, 10, 10] },
"triangleCount": 12,
"volume": 1000,
"watertight": true,
"genus": 0
}
Scale and split for printing
{
"tool": "make_printable_large_model",
"arguments": {
"input": "/models/ramp.stl",
"scale": 4,
"buildVolume": [256, 256, 256],
"connector": {
"type": "dowel",
"diameterMm": 12,
"depthMm": 25,
"clearanceMm": 0.2,
"countPerSeam": 4
},
"outputDir": "outputs/"
}
}
Slice a 3MF project
{
"tool": "slice_project",
"arguments": {
"project": "/path/to/model.3mf",
"plate": 0,
"settings": {
"machine": "profiles/printers/bambu_x1e.json",
"process": "profiles/process/petg_strong_030.json",
"filaments": ["profiles/filament/petg.json"]
}
}
}
See examples/ for more workflow examples.
Architecture
LLM Client (Claude, ChatGPT, etc.)
|
| MCP (stdio)
|
bambu-cli-mcp cad-geometry-mcp
├─ BambuStudio CLI ├─ manifold-3d (WASM)
│ adapter (execa) ├─ Binary STL I/O
├─ 11 tools ├─ 7 core + 4 workflow tools
├─ Zod schemas ├─ Connector engine
└─ Workspace manager └─ CAD engine detection
| |
v v
BambuStudio CLI In-process WASM
(orient, slice, (no Python, no subprocess)
export 3MF)
Key design decisions:
- pnpm monorepo with two logical servers in one repo
- manifold-3d WASM for geometry — single language, no Python dependency
- Recursive splitting — halves oversized parts until all fit build volume
- Surface-validated connectors — sphere intersection probes filter positions in empty space
- One 3MF per part — BambuStudio CLI stacks objects; individual exports avoid this
See Architecture Decision Records for full rationale.
Development
pnpm test # 29 tests across 7 files
pnpm build # TypeScript compilation
pnpm run lint # Type checking (tsc --noEmit)
pnpm run dev # Watch mode
Project structure
src/
index.ts # Entry point (--server flag)
bambu-cli-mcp/ # BambuStudio CLI wrapper
server.ts, tools/, adapters/, schemas/
cad-geometry-mcp/ # Geometry engine
server.ts, tools/, engines/, schemas/
shared/ # Workspace, errors, types
test/ # 7 test files, 29 tests
docs/adr/ # 6 architecture decision records
examples/ # Workflow JSON examples
profiles/ # Printer/process/filament configs
Environment Variables
| Variable | Description | Default |
|---|---|---|
BAMBU_STUDIO_PATH |
Path to BambuStudio binary | Auto-detected |
Tested with
- BambuStudio v02.06.01.55
- Node.js v22+ / v24
- macOS (ARM64)
- Bambu Lab X1E, P2S printers
License
MIT
bambu-cli MCP questions
What tools does bambu-cli MCP provide?
It exposes 22 tools, including inspect_bambu_cli, convert_to_3mf, arrange_project, orient_project, slice_project.
Can I split large models to fit my printer's build volume?
Yes, the server includes a recursive splitting tool that halves oversized parts until they fit within the specified build volume.
Does this require Python to run geometry operations?
No, it uses manifold-3d WASM for geometry processing, which means there is no Python dependency.
How do I select which tools to load?
You can use the --server flag to choose between 'bambu' (slicing), 'geometry' (mesh processing), or 'both' (all 22 tools).