# Qidi Printer MCP

> Qidi Printer MCP is an open-source MCP server for hardware testing. MCP server that lets AI assistants monitor and control QIDI 3D printers via Moonraker. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/csoai-org/qidi-printer-mcp
- **MCP Registry name:** io.github.CSOAI-ORG/qidi-printer-mcp
- **Categories:** hardware testing
- **Listing updated:** 2026-11-18

## About

The README says this server connects QIDI 3D printers to AI clients through the Moonraker API, so an assistant can check printer state and manage print jobs without a separate control panel. Setup is a pip install or a Smithery command, followed by a short entry in an MCP client config that launches it over stdio.

The examples in the README point to tools for reading printer status and temperatures and for starting a print. The listed tool names are printer_status, get_temperatures and start_print; no others are named in the documentation.

It suits people who run QIDI printers and want to drive them from Claude or another MCP-capable assistant, such as hobbyists or small makerspaces. The source is MIT-licensed and can be self-hosted; the vendor also offers paid compliance services that are separate from this server.

## Features

- **Printer status monitoring:** Reads the current state of a QIDI printer through the Moonraker API.
- **Temperature readings:** Returns printer temperatures so an assistant can report on heating status.
- **Start prints from an assistant:** Begins a print job when prompted through an MCP client.
- **Stdio transport setup:** Runs locally over stdio and installs with pip or uvx.
- **Smithery installation:** Can be installed for Claude clients with the Smithery CLI.

## Good for

- Checking a QIDI printer's status and temperatures from a chat with Claude
- Starting a print job from an AI assistant without opening the printer's web interface
- Automating routine print monitoring as part of a larger agent workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add qidi-printer-mcp -- uvx qidi-printer-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "qidi-printer-mcp": {
      "command": "uvx",
      "args": [
        "qidi-printer-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qidi-printer-mcp": {
      "command": "uvx",
      "args": [
        "qidi-printer-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qidi-printer-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "qidi-printer-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qidi-printer-mcp": {
      "command": "uvx",
      "args": [
        "qidi-printer-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qidi-printer-mcp": {
      "command": "uvx",
      "args": [
        "qidi-printer-mcp"
      ]
    }
  }
}
```

## Tools

- `printer_status`: Reports the printer's current status.
- `get_temperatures`: Returns printer temperature readings.
- `start_print`: Starts a print job.

## FAQ

### Which printers does it support?

The README describes it as an MCP server for QIDI 3D printers via the Moonraker API.

### How do I install it?

The README gives pip install qidi_printer_mcp, or npx -y @smithery/cli@latest install qidi-printer-mcp --client claude.

### Is it free?

The README states the repository is MIT-licensed and free to self-host.

### Is Qidi Printer MCP free?

Yes. Qidi Printer MCP is open source, so you can use and self-host it for free.

### How do I add Qidi Printer MCP to Claude Code?

Run this command in your terminal: claude mcp add qidi-printer-mcp -- uvx qidi-printer-mcp

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Eclipse Proving MCP](https://ai-powered.com/mcp/eclipse-proving-mcp): Eclipse Proving MCP is an MCP server for hardware testing.

---
Source: https://ai-powered.com/mcp/qidi-printer-mcp
