ATOMICMBAG

Duet MCP — AI skill for Claude Code

AI community

Duet-mcp - An MCP server that lets an AI assistant such as Claude operate a Duet machine (RepRapFirmware) over your LAN/WLAN: read status, manage files, look at camera pictures, home axes, start and s.

How to install Duet MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ATOMICMBAG/Duet-MCP and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Duet MCP does

Alternatives in AI

Maestro Companion — Quick execution for small tasks — minimal run lifecycle (start + done) with evidence recording 530 ★
Pi Agent Desktop — Pi — A cross-platform AI coding agent, bringing the Claude Code experience to your desktop 289 ★
AI Claude Start — Multi-profile Claude Code launcher with secure credential management 219 ★

README

duet-mcp

An MCP server (Model Context Protocol) that lets an AI assistant such as Claude operate a **Duet machine (RepRapFirmware)** over your LAN/WLAN: read status, manage files, look at camera pictures, home axes, start and supervise prints. The server is a safety layer between the AI and the machine.

_Deutsch: [README.de.md](README.de.md) (mit dem ausführlichen Plan und allen Ergebnissen)._

**Safety first.** Heaters and motors are dangerous. This is alpha software without any warranty. Never run it unattended and keep the emergency stop within reach. Read [SAFETY.md](SAFETY.md) before the first use, and see [SAFETY_RULES.md](SAFETY_RULES.md) for the rules the server enforces.

**Unofficial community project**, not affiliated with Duet3D. License: [MIT](LICENSE).

**Status: alpha.** Verified on one machine only: **Duet 2 WiFi, RepRapFirmware 3.2.x**, standalone, Cartesian printer. Everything else is "expected to work, untested". Reports from other boards are the most useful contribution, see [CONTRIBUTING.md](CONTRIBUTING.md).

Phone / PC ──► Claude ──► duet-mcp (local, stdio) ──► Duet (HTTP, LAN/WLAN)
                              └──► camera (HTTP / RTSP / local webcam)

![pic](Duet_MCP_Claude.jpg)

What it does

Read-only by default. Control tools exist only with DUET_READ_ONLY=false.
The human approves, not the AI. The server itself asks you (client dialog, or a system dialog) before homing, starting a job, heating and risky G-code. The AI cannot approve for you.
G-code guard: axis limits taken from your config.g, maximum temperatures, homed check, macro allowlist, blocked commands.
Pre-flight check of G-code files, with optional fixes in a patched copy.
Supervisor: pauses on heat-up timeout, temperature deviation, no progress, board restart or lost connection. Heaters left on are switched off by an idle watchdog.
Speed profile per layer (for example 30 % on layer 1, 50 % on layer 2).
**Camera s