MCP 如何接入本地打印機,讓 AI 助手直接列印
让 AI 助手直接出纸:MCP 接本地打印是怎么回事
作者介紹透過 MCP 將本地打印機接入 AI 助手,供開發調試及運維排障時調用列印工具,並不取代業務代碼中的打印流程。工具可查詢打印機及紙型、列印 HTML、PDF、圖片或批量列印,並以 `dry_run` 將預覽與實際列印分開。使用前須確保本地客戶端正在運行;MCP 只連接本機,生產流程仍使用原有 `web-print-pdf` npm 調用。
2026-11-20 5
版权
版权声明:
本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
简介: MCP打印协议让AI直接操控本地打印机:支持HTML/PDF/图片批量打印、纸型查询、预览(dry_run)与实打分离,专为开发调试和运维排障设计,不替代业务代码。(239字)
以前改小票样式是这么个循环:改 HTML,切回浏览器,刷新,点打印,跑到打印机拿纸,看一眼,回来再改。一天几十次,一半时间花在「看纸」上。
后来我把打印这件事直接接给了 AI 助手。不是让它写代码,是让它真的打一张。
直说吧:
MCP(Model Context Protocol)是给模型接工具的一套协议。打印 MCP 做的事很朴素:把「列打印机、查纸型、打 HTML、批量打」暴露成工具,模型调用,本机客户端出纸。它不替代业务里的 npm 包,管的是开发期和运维期的那只手。
接上之后,模型手里有哪些工具
| 工具 | 干什么 |
|---|---|
getConnectStatus |
本机客户端在不在线 |
getPrinterList |
这台机器装了哪些打印机 |
getPrinterPapers |
某台打印机支持哪些纸型 |
printHtml / printHtmlByUrl |
打一段 HTML,或让客户端去拉一个 URL |
printPdfByUrl / printPdfByBase64 |
直接打 PDF |
printImageByUrl / printImageByBase64 |
打图片 |
batchPrint |
一次提交多张,逐张带自己的参数 |
printFile |
打本机文件,按扩展名分通道 |
还有两个不起眼但很关键的东西:dry_run 只渲染不出纸,printer_name / paper_format 可以逐次指定。「先预览、再出纸」这件事在工具层就分开了,模型不会一激动把纸打光。
怎么接
在客户端的 MCP 配置里加一个 server,指向打印 MCP。不同客户端字段略有差别,思路一样:
{
"mcpServers": {
"web-print-pdf": {
"command": "npx",
"args": ["-y", "mcp-web-print-pdf"]
}
}
}
Windows 上如果 npx 起不来,把命令换成 cmd /c npx 那一套。配置完重启客户端,工具列表里能看到上面那些名字,就算通了。
三种我真实用过的场景
一、调边距和纸宽。 「按 58mm 打一张预览,左边距改成 2mm 再来一张」——它调 printHtml,dry_run 出一张预览图,我对比就行,不用切业务页。
二、现场排障。 客户说「打不出来」,先让它 getPrinterList,看名字里有没有那台机;再 getPrinterPapers 看纸型。以前这套要远程连过去点半天。
三、批量补打。 「这 12 个订单按面单打,失败的单列出来」——batchPrint 一次进去,失败项单独返回。补打的时候只重跑失败的那几张。
边界,说清楚免得误用
| 能做 | 不能做 |
|---|---|
| 开发机试打、样张对比 | 当业务用户的打印通道(他们不装 AI 客户端) |
| 运维远程补打、查打印机 | 替代页面里的 npm 调用 |
| 让模型看到「纸长什么样」 | 打到别人电脑上(MCP 也只连本机) |
| 快速验证纸张/边距/水印 | 绕过客户端直接操作打印机 |
前提只有一条:本机客户端得在跑。MCP 只是个转发层,客户端没起,工具再多也白搭——这跟业务侧 web-print-pdf 的判断标准是一样的。
业务侧还是那套代码
MCP 是开发期的入口,生产链路不变:
import webPrintPdf from 'web-print-pdf';
if (!(await webPrintPdf.utils.getConnectStatus())) {
throw new Error('客户端未连接');
}
await webPrintPdf.printHtml(html, {
paperFormat: '80mm' }, {
printerName: '收银-01' }, {
action: 'print' });
两条入口,同一个客户端,同一套参数。这个结构好处是:开发时怎么调的,上线后还是怎么调,不会出现「AI 能打、业务打不了」的错位。
排障表
| 现象 | 先查 |
|---|---|
| 工具列表是空的 | server 没起来;npx 拉包失败;配置路径写错 |
| 工具在,一调就报连不上 | 本机客户端没启动,或端口被占 |
| 打出来是 A4 | 没传 paper_format,走了默认纸 |
| 预览和出纸不一致 | 预览走了 dry_run,出纸另一套参数,检查是否同一份 |
| 模型反复重试打同一张 | 让它先 dry_run,确认后再 action: print |
AI 能替你按那个打印键,前提是那台机器上真有个东西接得住。MCP 解决的从来不是「会不会打印」,是「试错要不要跑一趟」。
來源:阿里雲開發者社區 AI · developer.aliyun.com