配置文件写好了,重启了,对话框里提「列出打印机」,模型说没有这个工具。MCP 面板里要么没有 server,要么是空壳。
直说吧:
工具列表空,九成不是打印 SDK 坏了,是 MCP 进程没真正跑起来,或 跑起来了但连不上本机客户端。按层拆,别反复重装 Claude。
配置应该长什么样
Claude Desktop 配置一般在:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"webprint": {
"command": "npx",
"args": ["-y", "mcp-web-print-pdf"]
}
}
}
改完必须完全退出再开。只关窗口有时不够。
Windows 上最常见的一刀
npx 在 GUI 进程里找不到。改成:
{
"mcpServers": {
"webprint": {
"command": "cmd",
"args": ["/c", "npx", "--yes", "mcp-web-print-pdf"]
}
}
}
仍空:在本机终端先跑一遍 npx -y mcp-web-print-pdf,看是缺 Node、证书问题,还是 npm 源超时。终端都拉不起来,Claude 里更起不来。
空列表 vs 有工具却不能打
| 现象 | 卡在哪 | 先查 |
|---|---|---|
| 设置里看不到 server | 配置 | 文件路径、JSON 逗号、是否被别的配置覆盖 |
| server 在但 Tools = 0 | 进程 | npx/cmd、Node PATH、首次拉包失败 |
| 有工具,一调就失败 | 客户端 | Web打印专家是否启动、端口、防火墙 |
| 能列打印机,不能出纸 | 参数/队列 | 打印机名、纸型、暂停的队列 |
有工具之后,让模型先查连接状态,再列打印机,再 dry_run,最后才真正出纸——顺序反了容易误判成「MCP 坏了」。
生产代码仍走业务包,不依赖 Claude:
import webPrintPdf from 'web-print-pdf';
if (!(await webPrintPdf.utils.getConnectStatus())) {
throw new Error('客户端未连接');
}
await webPrintPdf.printHtml(html, {
paperFormat: '80mm' }, {
printerName: '仓-面单-01' }, {
action: 'print' });
排障表
| 现象 | 先查 |
|---|---|
| 改配置毫无变化 | 是否改错用户目录;是否多开旧进程 |
| 首次能用、隔天空 | 公司清理了 npm cache;或 Node 版本被升级脚本改掉 |
| 只有某账号空 | 配置写在另一个 Windows 用户下的 APPDATA |
| 杀毒拦截 node/cmd | 放行后再看 MCP 日志 |
| 工具名对不上文档 | 包版本旧,更新 npx 缓存后再启 |
Claude Desktop 只是宿主。工具列表空,先让 mcp-web-print-pdf 在这台机器上自己站起来,再谈打印。