Skip to main content
Glama
mcp-web-print-pdf

mcp-web-print-pdf

by weixiaoyi

一句话:装一个 MCP server,模型就能「说一句、打一张」——不必截图、不必弹浏览器、不必让用户按 Ctrl+P。

它不改「Web打印专家」客户端,也不改 web-print-pdf 浏览器库——只是给客户端已有的 ws://127.0.0.1:16794/websocket/standard 再加一个客户端,并把 web-print-pdf@2.x 的公开 API 一对一映射成 16 个 MCP 工具。

Claude / Cursor / Cline / dsh ──stdio──> mcp-web-print-pdf ──ws──> Web打印专家客户端 ──> 打印机

为什么用它

你想要的

常见做法

用 mcp-web-print-pdf

让模型打印一张发票 / 报表

截图 → 手工打开 → Ctrl+P

模型调 printHtml,静默出纸

批量打 100 张面单

循环开页面、逐个确认

一次 batchPrint 提交混合任务

80mm 热敏小票

前端 window.print(),样式全乱

pdf_options 控制纸宽 / 边距 / 水印

打印本机 PDF

上传到网盘再让用户下载

printFile 按路径直连客户端

电子面单 / 标签机

需要专用 SDK

走系统打印驱动 + print_options

和 Playwright / Puppeteer 打印相比,它不是「无头浏览器另存 PDF」,而是调用本机已装好的打印驱动: 支持热敏、针式、标签机,支持纸盒 / 双面 / 缩放 / 锐化等驱动级参数,也不用额外下载 Chromium。

Related MCP server: printbridge

30 秒上手

{
  "mcpServers": {
    "webprint": {
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"]
    }
  }
}
  1. 装并启动 Web打印专家客户端(监听 ws://127.0.0.1:16794/websocket/standard)

  2. 把上面的 JSON 贴进宿主配置(各宿主位置见配置)

  3. 让模型先 getConnectStatus 探活,再 printHtml 出一张测试页

首次运行 npx 会自动下载并缓存;要固定版本写 npx -y mcp-web-print-pdf@0.2.3。

目录

支持的宿主

宿主

配置位置

顶层键

Claude Desktop

claude_desktop_config.json

mcpServers

Cursor

.cursor/mcp.json、~/.cursor/mcp.json

mcpServers

Claude Code

claude mcp add 或 .mcp.json

mcpServers

VS Code + Copilot

.vscode/mcp.json

servers

DeepSeek Harness(dsh)

cordis.patch.yml

—

Codex CLI

~/.codex/config.toml

[mcp_servers.…]

Cline / Roo / Kilo

cline_mcp_settings.json

mcpServers

Cherry Studio · Trae

图形界面

mcpServers

其它宿主

见下表

mcpServers

前置条件

安装

不需要安装。宿主通过 npx -y mcp-web-print-pdf 启动,首次运行会自动下载并缓存。

需要固定版本时在包名后加版本号,例如 npx -y mcp-web-print-pdf@0.2.3。

配置

所有宿主都通过 stdio 启动同一个 MCP server,统一用:

{ "command": "npx", "args": ["-y", "mcp-web-print-pdf"] }

从源码调试时,把 command 换成 node、args 换成 ["<repo>/bin/mcp.js"] 即可,其余字段不变。

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "webprint": {
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"],
      "env": { "WEBPRINT_PORT": "16794" }
    }
  }
}

Cursor

项目级 .cursor/mcp.json(只对当前项目生效),或全局 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "webprint": {
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"],
      "env": { "WEBPRINT_PORT": "16794" }
    }
  }
}

改完在 Cursor 的 Settings → MCP 里确认 webprint 是绿灯;工具会出现在 Agent 的工具列表里。

DeepSeek Harness(dsh)

dsh 用 @deepseek-ai/dsh-mcp-client 挂载外部 MCP。编辑当前 profile 的 ~/.dsh/profiles/<profile>/cordis.patch.yml,追加一段 insert:

- insert:
    - id: mcp-webprint
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: webprint
        transport: stdio
        command: npx
        args:
          - '-y'
          - 'mcp-web-print-pdf'
        toolCallTimeoutMs: 180000

保存后 dsh 会热加载(serverName 需匹配 [A-Za-z0-9_-]{1,32},且同一 profile 内唯一)。 模型侧看到的工具名带命名空间:mcp__webprint__printHtml、mcp__webprint__getPrinterList、 mcp__webprint__batchPrint …

Claude Code

claude mcp add --scope user webprint -- npx -y mcp-web-print-pdf
claude mcp list

--scope user 全局可用;去掉则只对当前项目生效。团队共享可以提交项目根的 .mcp.json:

{
  "mcpServers": {
    "webprint": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"]
    }
  }
}

VS Code + GitHub Copilot

.vscode/mcp.json(注意顶层是 servers,不是 mcpServers):

{
  "servers": {
    "webprint": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"]
    }
  }
}

命令面板运行 MCP: List Servers 可启动 / 重启 / 看输出;便携格式 .mcp.json 则用 mcpServers。

OpenAI Codex CLI

~/.codex/config.toml:

[mcp_servers.webprint]
command = "npx"
args = ["-y", "mcp-web-print-pdf"]

Cline / Roo Code / Kilo Code

Cline 面板 → MCP Servers → Configure → Configure MCP Servers,编辑 cline_mcp_settings.json:

{
  "mcpServers": {
    "webprint": {
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"],
      "disabled": false
    }
  }
}

Roo Code / Kilo Code 是 Cline 的分叉,配置结构相同,只是文件路径不同。

Cherry Studio

设置 → MCP 服务器 → 添加服务器:

  • 类型:STDIO

  • 命令:npx

  • 参数:-y mcp-web-print-pdf

保存后回到聊天框,打开输入框旁的 MCP 开关即可。

Trae

设置 → MCP → 手动添加,粘贴:

{
  "mcpServers": {
    "webprint": {
      "command": "npx",
      "args": ["-y", "mcp-web-print-pdf"]
    }
  }
}

项目级配置放在 .trae/mcp.json(需先在设置里打开「项目级 MCP」)。

其它宿主

宿主

配置位置

顶层键

CodeBuddy

settings.json

mcpServers(加 "disabled": false)

Qoder

~/.qoder/settings.json

mcpServers(或 qoder mcp add webprint -- npx -y mcp-web-print-pdf)

JetBrains AI Assistant

Settings → Tools → AI Assistant → MCP → Add

mcpServers(也可直接 Import from Claude)

Windsurf

~/.codeium/windsurf/mcp_config.json

mcpServers

GitHub Copilot CLI

~/.copilot/mcp-config.json

mcpServers

ChatGPT / claude.ai 网页版只接受远程 HTTP MCP,不能直连本机的 stdio server;要支持它们需要再加一层 HTTP 桥(本项目暂未提供)。Gemini CLI 个人版已转向 Antigravity,这里不再单列。

客户端端口默认 16794,可用 WEBPRINT_PORT 覆盖;WebSocket 请求超时默认 120s,可用 WEBPRINT_TIMEOUT(毫秒)覆盖。

工具

工具名与 web-print-pdf@2.x 的方法名一一对应(utils. 前缀不能出现在 MCP 工具名里,故省略)。 只有 printFile 是本仓库额外加的——上游没有「按本机路径打印」的方法。

状态与打印机

工具

对应

作用

getConnectStatus

utils.getConnectStatus

检查客户端是否在线

getPrinterList

utils.getPrinterList

列出本机打印机(名称 + 驱动)

getPrinterPapers

utils.getPrinterPapers

查询某台打印机支持的纸张,用于填 paper_format / print_options.bin

打印

所有打印工具默认 dry_run: false:直接出纸;要只渲染预览请显式传 dry_run: true (或 extra_options.action: "preview")。默认会真的用纸,请先确认打印机和纸张。

不传 paper_format 时,PDF 渲染默认用 A4,但打印阶段会沿用客户端默认打印机的纸张。 要固定纸张(比如热敏 80mm、面单 100×150),请显式传 paper_format / pdf_options。

工具

作用

printHtml

打印 HTML 字符串

printHtmlByUrl

抓取网页后打印

printHtmlByBase64

打印 Base64 HTML

printPdfByUrl

打印 PDF 链接

printPdfByBase64

打印 Base64 PDF

printImageByUrl

打印图片链接

printImageByBase64

打印 Base64 图片

printFile

按扩展名自动选通道,打印本机 .pdf / .html / 图片(额外提供)

batchPrint

一次提交多个混合任务

batchPrint 的任务格式以客户端为准:每项是 { type, data, pdfOptions?, printOptions?, extraOptions? }, 不是上游 README 示例里的 content / url / base64。data 按 type 解释:printHtml 放 HTML, …ByUrl 放地址,…ByBase64 放 base64。

客户端设置

工具

对应

说明

setTitle

utils.setTitle(title | null)

设置窗口标题

setThemeColor

utils.setThemeColor(color | null)

设置主题色

switchTabsVisibility

utils.switchTabsVisibility(tabs | null)

切换标签页显隐

setContactUsTabInnerHtml

utils.setContactUsTabInnerHtml(html | null)

设置「联系我们」页面

这四个都支持 reset: true 恢复默认——有些宿主会把 JSON null 序列化成字符串 "null",这时用 reset: true 比传 null 稳。

0.1.0 用的是 snake_case(print_status / list_printers / print_html / print_pdf_url), 0.2.0 起统一改成上游方法名,对应关系:print_status → getConnectStatus、list_printers → getPrinterList、print_html → printHtml、print_pdf_url → printPdfByUrl。

参数

打印工具共用一套参数,与上游四个实参一一对应:

MCP 参数

对应

说明

内容字段

第 1 个实参

html / url / base64 / path / tasks

pdf_options

pdfOptions

排版成 PDF:纸张、边距、页眉页脚、背景、水印、页码…

print_options

printOptions

投递打印机:打印机名、份数、单双面、缩放、纸盒、热敏锐化…

extra_options

extraOptions

action、requestTimeout、cookies、httpHeaders、localStorages…

dry_run

—

默认出纸;true 只预览;显式 action 优先

paper_format

—

便捷参数,等价于 print_options.paperFormat

printer_name

—

便捷参数,等价于 print_options.printerName

copies

—

便捷参数,等价于 print_options.copies

三个 options 对象中,pdf_options / print_options 走客户端白名单校验(字段名写错会直接报错); extra_options 允许任意自定义键,会原样透传并在响应里返回。

合并规则:对象里显式写的字段优先,便捷参数只补空缺。

pdf_options

paperFormat、width、height、displayHeaderFooter、headerTemplate、footerTemplate、 landscape、margin{top,right,bottom,left}、pageRanges[{from,to}]、preferCSSPageSize、 printBackground、scale、outline、tagged、watermark、pageNumber。

pdfOptions.paperFormat 只认固定枚举(A0–A6 / Letter / Legal / Tabloid / Ledger)。 80mm 小票、100×150 面单这类自定义尺寸请改用 width + height,不要设 paperFormat。

print_options

paperFormat(任意纸名,含打印机专有尺寸)、colorful、landscape、printerName、 pageRanges、copies、duplexMode(simplex / duplex / duplexshort / duplexlong)、 scaleMode(noscale / shrink / fit)、subset(odd / even)、bin、sharp、 dpi / threshold(sharp: true 时的光栅参数,默认 203 / 160)。

extra_options

action(print / preview)、requestTimeout(秒)、devtool、cookies、httpHeaders、 localStorages、sessionStorages,以及任意自定义键(会随响应原样返回)。

示例

预览一张 A4 发票(不出纸):

{
  "tool": "printHtml",
  "arguments": {
    "html": "<h1>发票 #12345</h1><p>合计 ¥99.99</p>",
    "dry_run": true,
    "paper_format": "A4",
    "pdf_options": { "printBackground": true, "margin": { "top": "10mm", "bottom": "10mm" } }
  }
}

真正打印到指定打印机、双面、两份:

{
  "tool": "printHtml",
  "arguments": {
    "html": "<h1>对账单</h1>",
    "dry_run": false,
    "printer_name": "财务室激光",
    "copies": 2,
    "print_options": { "duplexMode": "duplex", "colorful": false }
  }
}

打印 80mm 热敏小票(自定义纸宽):

{
  "tool": "printHtml",
  "arguments": {
    "html": "<div style='width:72mm'>小票内容</div>",
    "dry_run": false,
    "pdf_options": { "width": "80mm", "height": "297mm", "margin": { "top": "0", "bottom": "0", "left": "2mm", "right": "2mm" } },
    "print_options": { "paperFormat": "80mm", "sharp": true }
  }
}

打印本机 PDF 文件:

{ "tool": "printFile", "arguments": { "path": "<path-to-pdf>", "dry_run": false } }

批量混合任务:

{
  "tool": "batchPrint",
  "arguments": {
    "dry_run": false,
    "printer_name": "仓库标签机",
    "tasks": [
      { "type": "printHtml", "data": "<h1>面单 1</h1>" },
      { "type": "printPdfByUrl", "data": "https://example.com/a.pdf" },
      { "type": "printHtmlByUrl", "data": "https://example.com/report" }
    ]
  }
}

批量任务里每个 extraOptions.action 必须一致(客户端在浅合并后会校验),所以别在单个任务里 混用 print 和 preview;统一用顶层 dry_run 控制即可。

常见问题 FAQ

MCP 是什么?为什么打印要经过 MCP?

MCP(Model Context Protocol)是模型调用外部工具的通用协议。把打印能力做成 MCP server 后, Claude、Cursor、Cline、dsh 这些宿主不用各写一套对接代码,接一次就能在所有宿主里用同一批工具。

需要联网吗?

不需要。所有打印请求都走本机 ws://127.0.0.1:16794/websocket/standard,只有首次 npx 下载包时需要网络。

需要额外买授权吗?

预览(extra_options.action = "preview" / dry_run: true)只渲染不送印,不检查授权; 正式出纸由 Web打印专家客户端校验,未授权时会返回 Not allowed to use, please purchase authorization。

会不会「偷偷」打印、浪费纸?

默认 dry_run: false 是直接出纸(和服务端 API 语义一致)。调试阶段请显式传 dry_run: true, 确认排版后再改成 false。

支持热敏小票机 / 标签打印机吗?

支持。热敏、针式、面单机都走系统打印驱动,用 pdf_options.width/height 控制版面, 用 print_options.paperFormat 指定驱动里的纸名,必要时开 sharp: true + dpi 提升小票清晰度。

和 Playwright / Puppeteer 打印有什么区别?

Playwright 是在无头 Chromium 里渲染成 PDF 再调用系统打印,需要单独下载浏览器内核, 拿不到驱动级参数(纸盒、锐化、双面翻转);本项目直接把参数交给已经装好的客户端和驱动, 更贴近「真的在这台机器上打印」。

支持 macOS / Linux / 国产系统吗?

客户端支持 Windows 10/11、macOS 11+,以及 Linux / 银河麒麟 / 统信 UOS;本 MCP 是纯 Node 进程(Node ≥ 18), 能跑客户端的地方就能跑它。

为什么预览只返回一个 URL,模型看不到图?

预览返回的是 pdfUrl / printPreviewUrl,MCP 通道里没有图片内容。要让模型「看图」, 需要额外把 PDF 转成 PNG 再喂给模型。

大文件 / 大 HTML 为什么失败?

MCP 的 stdio 单条消息默认上限 10MB,Base64 会再膨胀约 4/3。大文件请用 printFile(本机读文件) 或先挂到 HTTP 地址用 printPdfByUrl / printImageByUrl。

端口不是 16794 怎么办?

设环境变量 WEBPRINT_PORT;请求超时设 WEBPRINT_TIMEOUT(毫秒)。这两个都从宿主配置的 env 传入。

能让 ChatGPT / claude.ai 网页版直接用吗?

暂时不行。网页版只接受远程 HTTP MCP,需要额外一层 HTTP 桥接本机 stdio server(本项目未提供)。

打印出来是空白 / 内容被截断?

通常是纸张尺寸和内容不匹配:显式传 paper_format 或 pdf_options.width/height,并打开 printBackground: true(背景色 / 背景图默认不打)。

大文件怎么打

MCP 的 stdio 通道单条消息默认上限 10MB(SDK 的 ReadBuffer),所以:

  • printHtmlByBase64 / printPdfByBase64 / printImageByBase64 只适合小文件—— 约 7MB 以内的 base64(≈5MB 原始文件)。超过后连接会被直接关闭,工具里来不及报错。

  • 大 PDF / 图片 / HTML 请用 printFile:由 MCP server 在本机读取文件,再通过 WebSocket 发给 客户端,绕开 MCP 的消息上限。

  • 也可以先把文件挂到 HTTP 地址,用 printPdfByUrl / printImageByUrl / printHtmlByUrl。

与 web-print-pdf@2.1.9 的覆盖对照

上游公开 API

本 MCP

printHtml / printHtmlByUrl / printHtmlByBase64

✅ 同名

printPdfByUrl / printPdfByBase64

✅ 同名

printImageByUrl / printImageByBase64

✅ 同名

batchPrint

✅ 同名

utils.getConnectStatus / utils.getPrinterList / utils.getPrinterPapers

✅ 去掉 utils. 前缀后同名

utils.setTitle / utils.setThemeColor / utils.switchTabsVisibility / utils.setContactUsTabInnerHtml

✅ 去掉 utils. 前缀后同名

utils.onResponse / utils.onError

— 事件回调,MCP 里每个调用都有返回值,不需要

_printByRawMessage

— 下划线私有 API,未纳入

外加一个上游没有的方法:printFile(按本机路径打印,避免把大文件塞进 MCP 消息)。

实现要点

  • 请求字段放在消息顶层(content / url / printOptions …),不在 data 里;这是客户端 websocket/standard/index.js 的约定,与 web-print-pdf 的 dist/index.js 一致。

  • 响应形如 { id, type, timestamp, success, data },data 里通常有 pdfFileName / pdfUrl / printPreviewUrl / pdfPath。

  • extraOptions.action = 'preview' 时,客户端走 core/printPdf._printPreview(),只渲染不送印, 也不检查授权;action = 'print' 才会检查 NOTALLOWUSE。

  • pdfOptions.paperFormat 只认固定枚举;printOptions.paperFormat 认任意纸名——代码里对两者分别处理。

  • 客户端对 pdfOptions / printOptions 做白名单校验,未知字段直接报错;extraOptions 允许自定义键。

  • HTML / PDF 的 Base64 入参会去掉 data:...;base64, 前缀和空白字符;图片通道相反——客户端要求 data:image/...;base64, 前缀并把它原样塞进 <img src>,所以服务端会对裸 base64 按文件头补前缀。

  • stdout 是 MCP 协议通道,日志一律走 stderr。

  • 客户端侧实现见 ElctronPrintWeb 仓库:消息入口在 electronApp/server/websocket/standard/, 参数白名单在 core/generatePdf 与 core/printPdf。

本地开发

git clone https://github.com/weixiaoyi/mcp-web-print-pdf.git
cd mcp-web-print-pdf
npm install
npm test

npm test 跑参数合并和默认 action 的单元测试;端到端冒烟见下一节。

本地验证(没装客户端也能跑)

# 终端 1:假客户端(覆盖全部消息类型)
node test/mock-server.js

# 终端 2:端到端冒烟,会走一遍 16 个工具
node test/smoke.js

# 或交互式调试
npx @modelcontextprotocol/inspector node bin/mcp.js

装好宿主后也可以直接用模型验证:dsh 下工具名是 mcp__webprint__printHtml 这种带命名空间的形式, 先 getConnectStatus 探活,再 printHtml + dry_run: true 看预览是否生成即可。

已知边界

  • 只支持本机已启动的客户端;没有云端中继。

  • 打印是异步队列,返回的是「已提交」,不是「已出纸」。

  • 「已提交」只代表进了 Windows 打印队列;打印机暂停 / 离线 / 缺纸时队列会停住。可用 Get-PrintJob -PrinterName "<打印机名>" 看作业状态,别只看工具返回值。

  • 未授权时 dry_run: false 会报 Not allowed to use, please purchase authorization。

  • 预览返回的是 URL,agent 看不到图;要「给模型看图」还需把 PDF 转 PNG。

  • printFile 会读取 agent 指定的本机文件,只应在可信环境里启用。

  • 走 Base64 的工具受 MCP stdio 10MB 单条消息上限约束,大文件用 printFile 或 URL 通道。

  • 批量任务的所有 extraOptions.action 必须一致,否则客户端报错。

  • MCP 宿主一般给单次工具调用 60s 左右超时;批量或大文件可能被宿主掐断,需要调大宿主超时或拆批。

  • 预览模式下非法的 printerName 可能被客户端忽略而不报错,正式出纸前建议用 action: "print" 验证。

  • 参数与消息结构按 ElctronPrintWeb(客户端 1.0.9)源码校准:batchPrint 任务用 data 字段, 不是 web-print-pdf README 示例里的 content / url / base64。

相关链接

贡献

Issue、PR、文档纠错都欢迎,先看 CONTRIBUTING.md。

如果这个项目帮你省了时间,点个 ⭐ 能让更多找「MCP 打印」的人看到它。

License

MIT

Available Tools

16 tools
batchPrintA

一次提交多个打印任务(HTML / 网页 / PDF / 图片,URL 或 Base64 混合)。默认出纸;dry_run: true 只预览

Inputs: tasks (required), copies, dry_run, pdf_options, +4 more.

getConnectStatusB

检查本地「Web打印专家」客户端是否在线

Inputs: no named parameters.

getPrinterListA

列出本机可用的打印机(名称 + 驱动)

Inputs: no named parameters.

getPrinterPapersA

查询指定打印机支持的纸张列表,用于填 paper_format / print_options.paperFormat / print_options.bin

Inputs: printer_name (required), driver_name.

printFileA

打印本机文件:按扩展名自动选择 PDF / HTML / 图片通道。默认出纸;dry_run: true 只预览

Inputs: path (required), copies, dry_run, pdf_options, +4 more.

printHtmlA

把 HTML 字符串渲染成 PDF 并打印。默认真正出纸;dry_run: true 才只渲染预览

Inputs: html (required), copies, dry_run, pdf_options, +4 more.

printHtmlByBase64B

把 Base64 编码的 HTML 渲染成 PDF 打印。默认出纸;dry_run: true 只预览

Inputs: base64 (required), copies, dry_run, pdf_options, +4 more.

printHtmlByUrlA

抓取一个网页并渲染成 PDF 打印。默认出纸;dry_run: true 只预览;登录态可用 extra_options.cookies / httpHeaders / localStorages 处理

Inputs: url (required), copies, dry_run, pdf_options, +4 more.

printImageByBase64A

把 Base64 编码的图片打印。默认出纸;dry_run: true 只预览;缺 data:image/...;base64, 前缀时会自动补

Inputs: base64 (required), copies, dry_run, pdf_options, +4 more.

printImageByUrlA

下载一张图片并打印。默认出纸;dry_run: true 只预览

Inputs: url (required), copies, dry_run, pdf_options, +4 more.

printPdfByBase64A

把 Base64 编码的 PDF 打印。默认出纸;dry_run: true 只预览

Inputs: base64 (required), copies, dry_run, pdf_options, +4 more.

printPdfByUrlB

下载一个 PDF 链接并打印。默认出纸;dry_run: true 只预览

Inputs: url (required), copies, dry_run, pdf_options, +4 more.

setContactUsTabInnerHtmlA

设置客户端「联系我们」页面的 HTML;reset: true(或 html: null)= 恢复默认

Inputs: html, reset.

setThemeColorB

设置客户端主题色,如 rgb(229,182,80);reset: true(或 theme_color: null)= 恢复默认

Inputs: reset, theme_color.

setTitleA

设置客户端窗口标题;reset: true(或 title: null)= 恢复默认

Inputs: reset, title.

switchTabsVisibilityB

切换客户端 5 个标签页的显隐;reset: true(或 tabs: null)= 全部恢复默认

Inputs: tabs, reset.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 16 tools

    Disambiguation4/5

    The print family is cleanly partitioned by source type (Html/Pdf/Image) and delivery (string/URL/Base64), and descriptions state each channel clearly. The only mild overlaps are printFile's auto-detection vs. the explicit format tools and batchPrint duplicating single-print capability, but descriptions make the intended routing obvious.

    Naming Consistency4/5

    Names are consistently camelCase and verb-first (get*/print*/set*), with the print tools following a predictable print<Format>By<Source> pattern. Minor deviations: batchPrint is noun-first and switchTabsVisibility uses a different verb family than the other setters.

    Tool Count4/5

    Sixteen tools sits at the upper edge of reasonable, but the matrix of three formats by three sources plus discovery, batch, and four UI setters means each tool has a distinct role. It could be consolidated (e.g. one print tool with a type param), but nothing feels redundant.

    Completeness3/5

    Discovery (status, printers, papers) and submission (all formats, batch, dry-run preview) are well covered, but there is no way to query print-job status/history or cancel a queued job, which leaves an agent unable to confirm outcomes after submission. UI customization is complete but peripheral to the core print domain.

    Related MCP Connectors

    • Print from Claude and ChatGPT to your own printer. Free for 5 prints a month; Plus $7.99/mo.

      https://getprintbot.com/mcp
    • Have It Printed turns a document or a letter an AI assistant just helped you write into real mail. No printer, no ink, no trip to the post office. The assistant starts a job, adds the document (a file, or text it wrote with you), picks how it is mailed and gets the exact price from Have It Printed's own page count. Then it creates a checkout link: you enter the address and pay on haveitprinted.com, so no address or card ever goes through the chat. After payment it can check the order and read the tracking number. Ways to mail: flat and tracked (the default), printed and mailed flat in a rigid mailer with a free tracking number, from $15 for up to 30 pages; a $3 letter of up to 5 pages, folded into a standard envelope and mailed USPS First-Class with no tracking; or $11 by USPS Certified Mail with a tracking number. With an API key, agents can also write letters in a handwriting-style font on designed stationery, send postcards from $2, and pay on their own with a Stripe shared payment token (the bank's checks still apply). Prices include printing and postage. Letters, Certified Mail and postcards go to US addresses; flat and tracked also ships to Canada, Mexico, the UK, Germany, Australia and Japan. Uploaded files are deleted automatically and never used to train AI. Docs: https://haveitprinted.com/developers.html

    • Print shop for AI agents: business cards, flyers, posters. Returns a proof, a price and a pay link.

      https://thedesignprint.com/mcp
    • A real browser for your agent: screenshots, page checks, Markdown and PDFs.

      https://shotlane.dev/mcp

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to submit PDFs or JSON-rendered templates to local printers, check printer status, and manage print jobs through MCP tools.
      26 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to print documents directly on your own printer over a private network, without cloud services or open ports. Supports printing text, URLs, and files with per-person access keys, usage limits, and detailed job control.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets an AI assistant discover the printers installed on a computer and send them PDFs, images, text, Markdown, or HTML with control over copies, page ranges, paper size, orientation, duplex, and color, then track or cancel the resulting jobs. It can run locally over stdio or be exposed remotely through a Cloudflare tunnel with password authentication.
      54 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to drive cloud printers: listing available printers, sending PDFs, ZPL labels and ESC/POS receipts, tracking print jobs through to completion, and managing webhooks. It connects an MCP client to the InkRelay printing API so printing happens from natural language requests.
      MIT