# Bambu Project QA MCP

Local MCP tools for inspecting Bambu Studio projects before printing. This is intentionally a project QA and preparation server, not a full printer-control server.

## Tools

- `inspect_model`: inspect a `.stl` or `.3mf`.
- `inspect_3mf_project`: validate a Bambu Studio `.3mf` and report risky support/slicer settings.
- `create_leg_safe_support_variant`: create a `.3mf` copy with easier-removal support settings for delicate horse legs/details.
- `open_in_bambu_studio`: open a file in Bambu Studio on this Windows machine.

## Safety Limits

- This server does not start prints.
- It does not handle Bambu LAN access codes, printer serial numbers, MQTT, or FTPS.
- It does not auto-paint support blockers. Bambu support painting metadata is not documented and was not present in the inspected local projects.
- It validates 3MF ZIP paths so generated files use forward slashes and open correctly in Bambu Studio.

## Run Tests

```powershell
npm.cmd test
```

## MCP Configuration

Use a local stdio server:

```json
{
  "mcpServers": {
    "bambu-project-qa": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/bambu-project-qa-mcp/bin/bambu-project-qa-mcp.js"
      ],
      "env": {}
    }
  }
}
```

## Example Tool Inputs

Inspect a project:

```json
{
  "path": "/path/to/models/horses_frame_4in_P2S.3mf"
}
```

Create a leg-safe support variant:

```json
{
  "inputPath": "/path/to/models/horses_frame_4in_P2S.3mf",
  "outputPath": "/path/to/models/horses_frame_4in_leg_safe_P2S.3mf"
}
```