MCP标签打印机
MCP服务器,用于通过P-touch Editor Lite将带有二维码的标签打印到Brother QL-810W打印机。
先决条件
- Python 3.10+ - 下载
- 兄弟QL-810W 通过USB连接的打印机
- 编辑器精简模式已启用 打印机上(绿色LED亮起)
安装
- 克隆存储库:
git clone https://github.com/calumjs/MCP.Printer.git
cd MCP.Printer- 安装软件包:
pip install -e .这将安装所有依赖项(Pillow、qrcode、brother_ql、mcp)。
- 验证安装:
python -c "from mcp_label_printer.printer import print_label; print('OK')"打印机设置
- 通过USB连接兄弟QL-810W
- 按下 编辑器精简版按钮 直到绿色LED亮起
- 打印机应显示为USB驱动器(通常
D:\) - 验证
D:\PTLITE.PRN存在
MCP配置
添加到MCP配置文件中:
对于光标 (~/.cursor/mcp.json):
{
"mcpServers": {
"label-printer": {
"command": "mcp-label-printer"
}
}
}替代 (如果找不到命令):
{
"mcpServers": {
"label-printer": {
"command": "python",
"args": ["-m", "mcp_label_printer.server"]
}
}
}添加配置后重新启动IDE。
用法
服务器公开了一个工具:
print_label
打印带有二维码和文字的标签。
| 参数 | 必填 | 说明 |
|---|---|---|
url | 是 | 要编码为二维码的URL |
issue_number | 是 | 问题/PR编号(例如“#1234”) |
title | 是 | 问题/PR标题 |
description | 否 | 简要说明 |
示例提示:
用URL打印问题#42“修复登录错误”的标签https://github.com/org/repo/issues/42
运作原理
- 从URL生成二维码
- 使用二维码+文本创建标签图像
- 转换为Brother QL光栅格式
- 写信给
D:\PTLITE.PRN具有适当的填充(112640字节) - 写入文件时,打印机会自动打印
故障排除
没有打印:
- 确保Editor Lite LED亮起(绿色)
- 检查
D:\驱动器存在并包含PTLITE.PRN - 尝试从P-touch Editor Lite应用程序打印,以验证打印机是否正常工作
未找到命令:
- 确保Python脚本文件夹位于PATH中
- 使用替代配置
python -m mcp_label_printer.server
标签尺寸错误:
- 此配置用于62mm连续标签(DK-22205)
