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.

Parameter	Required	Description
url	Yes	URL to encode in QR code
issue_number	Yes	Issue/PR number (e.g., "#1234")
title	Yes	Issue/PR title
description	No	Brief description

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)