# 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](https://www.python.org/downloads/)
- **Brother QL-810W** printer connected via USB
- **Editor Lite mode enabled** on printer (green LED on)
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/calumjs/MCP.Printer.git
cd MCP.Printer
```
2. **Install the package:**
```bash
pip install -e .
```
This installs all dependencies (Pillow, qrcode, brother_ql, mcp).
3. **Verify installation:**
```bash
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`):
```json
{
"mcpServers": {
"label-printer": {
"command": "mcp-label-printer"
}
}
}
```
**Alternative** (if command not found):
```json
{
"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)
