MCP Label Printer

An MCP server for printing labels with QR codes to Brother QL-810W printer via P-touch Editor Lite.

Prerequisites

• Python 3.10+ - Download

• Brother QL-810W printer connected via USB

• Editor Lite mode enabled on printer (green LED on)

Installation

1. Clone the repository:

   git clone https://github.com/calumjs/MCP.Printer.git
   cd MCP.Printer

2. Install the package:

   pip install -e .

   This installs all dependencies (Pillow, qrcode, brother_ql, mcp).

3. Verify installation:

   python -c "from mcp_label_printer.printer import print_label; print('OK')"

Printer Setup

1. Connect Brother QL-810W via USB

2. Press the Editor Lite button until the green LED turns ON

3. The printer should appear as a USB drive (usually D:\)

4. Verify D:\PTLITE.PRN exists

MCP Configuration

Add to your MCP config file:

For Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "label-printer": {
      "command": "mcp-label-printer"
    }
  }
}

Alternative (if command not found):

{
  "mcpServers": {
    "label-printer": {
      "command": "python",
      "args": ["-m", "mcp_label_printer.server"]
    }
  }
}

Restart your IDE after adding the config.

Usage

The server exposes one tool:

print_label

Print a label with QR code and text.

Example prompt:

Print a label for issue #42 "Fix login bug" with URL https://github.com/org/repo/issues/42

How It Works

1. Generates a QR code from the URL

2. Creates a label image with QR code + text

3. Converts to Brother QL raster format

4. Writes to D:\PTLITE.PRN with proper padding (112,640 bytes)

5. Printer automatically prints when file is written

Troubleshooting

Nothing prints:

• Ensure Editor Lite LED is ON (green)

• Check D:\ drive exists and contains PTLITE.PRN

• Try printing from P-touch Editor Lite app to verify printer works

Command not found:

• Ensure Python Scripts folder is in PATH

• Use the alternative config with python -m mcp_label_printer.server

Wrong label size:

• This is configured for 62mm continuous labels (DK-22205)