AI导哈

标签打印服务

一个通过P-touch Editor Lite在Brother QL-810W打印机上打印带二维码标签的MCP服务器。

  • by calumjs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 calumjs/MCP.Printer

使用说明

MCP标签打印机

MCP服务器，用于通过P-touch Editor Lite将带有二维码的标签打印到Brother QL-810W打印机。

先决条件

  • Python 3.10+ - 下载
  • 兄弟QL-810W 通过USB连接的打印机
  • 编辑器精简模式已启用 打印机上（绿色LED亮起）

安装

  1. 克隆存储库：

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

  2. 安装软件包：

    pip install -e .

    这将安装所有依赖项（Pillow、qrcode、brother_ql、mcp）。

  3. 验证安装：

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

打印机设置

  1. 通过USB连接兄弟QL-810W
  2. 按下 编辑器精简版按钮 直到绿色LED亮起
  3. 打印机应显示为USB驱动器（通常 D:\)
  4. 验证 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

运作原理

  1. 从URL生成二维码
  2. 使用二维码+文本创建标签图像
  3. 转换为Brother QL光栅格式
  4. 写信给 D:\PTLITE.PRN 具有适当的填充（112640字节）
  5. 写入文件时，打印机会自动打印

故障排除

没有打印：

  • 确保Editor Lite LED亮起（绿色）
  • 检查 D:\ 驱动器存在并包含 PTLITE.PRN
  • 尝试从P-touch Editor Lite应用程序打印，以验证打印机是否正常工作

未找到命令：

  • 确保Python脚本文件夹位于PATH中
  • 使用替代配置 python -m mcp_label_printer.server

标签尺寸错误：

  • 此配置用于62mm连续标签（DK-22205）

相关 MCP