mcp-web-print-pdf 0.2.1 → 0.2.3

package/README.md

@@ -8,19 +8,26 @@
 `ws://127.0.0.1:16794/websocket/standard` 再加一个客户端，并把 `web-print-pdf@2.x` 的公开 API
 一对一映射成 MCP 工具。
 
+- 官网：<https://webprintpdf.com/>
+- 底层 npm 包：[web-print-pdf](https://www.npmjs.com/package/web-print-pdf)
+- 文档：<https://webprintpdf.com/docs/>
+
 ```
 Claude / dsh ──stdio──> mcp-web-print-pdf ──ws──> Web打印专家客户端 ──> 打印机
 ```
 
-## 安装
+## 前置条件
 
-宿主会自动通过 `npx -y mcp-web-print-pdf` 拉取，不需要全局安装。
+- 本机安装并启动 [Web打印专家客户端](https://webprintpdf.com/downloadApp/)（Windows 10/11、macOS 11+、Linux / 银河麒麟 / 统信 UOS）
+- 客户端默认监听 `ws://127.0.0.1:16794/websocket/standard`
+- 不需要改客户端或前端代码；本 MCP 只是把 [web-print-pdf](https://www.npmjs.com/package/web-print-pdf) 的公开 API 映射成 MCP 工具
+- MCP 接入指南：<https://webprintpdf.com/docs/mcp-print/>
 
-从源码开发：
+## 安装
 
-```bash
-npm install
-```
+不需要安装。宿主通过 `npx -y mcp-web-print-pdf` 启动，首次运行会自动下载并缓存。
+
+> 需要固定版本时在包名后加版本号，例如 `npx -y mcp-web-print-pdf@0.2.3`。
 
 ## 配置
 
@@ -374,7 +381,7 @@ MCP 的 stdio 通道单条消息默认上限 **10MB**（SDK 的 `ReadBuffer`）
   客户端，绕开 MCP 的消息上限。
 - 也可以先把文件挂到 HTTP 地址，用 `printPdfByUrl` / `printImageByUrl` / `printHtmlByUrl`。
 
-## 与 `web-print-pdf@2.1.9` 的覆盖对照
+## 与 [web-print-pdf@2.1.9](https://www.npmjs.com/package/web-print-pdf) 的覆盖对照
 
 | 上游公开 API | 本 MCP |
 |---|---|
@@ -405,6 +412,17 @@ MCP 的 stdio 通道单条消息默认上限 **10MB**（SDK 的 `ReadBuffer`）
 - 客户端侧实现见 `ElctronPrintWeb` 仓库：消息入口在 `electronApp/server/websocket/standard/`，
   参数白名单在 `core/generatePdf` 与 `core/printPdf`。
 
+## 本地开发
+
+```bash
+git clone https://github.com/weixiaoyi/mcp-web-print-pdf.git
+cd mcp-web-print-pdf
+npm install
+npm test
+```
+
+`npm test` 跑参数合并和默认 action 的单元测试；端到端冒烟见下一节。
+
 ## 本地验证（没装客户端也能跑）
 
 ```bash
@@ -437,6 +455,15 @@ npx @modelcontextprotocol/inspector node bin/mcp.js
 - 参数与消息结构按 `ElctronPrintWeb`（客户端 1.0.9）源码校准：`batchPrint` 任务用 `data` 字段，
   不是 `web-print-pdf` README 示例里的 `content` / `url` / `base64`。
 
+## 相关链接
+
+- 官网：<https://webprintpdf.com/>
+- 文档：<https://webprintpdf.com/docs/>
+- MCP 接入指南：<https://webprintpdf.com/docs/mcp-print/>
+- 客户端下载：<https://webprintpdf.com/downloadApp/>
+- web-print-pdf（npm）：<https://www.npmjs.com/package/web-print-pdf>
+- 本仓库：<https://github.com/weixiaoyi/mcp-web-print-pdf>
+
 ## License
 
 MIT

package/README_EN.md

@@ -8,19 +8,27 @@ It does **not** modify the Web Print Expert client or the `web-print-pdf` browse
 adds another client to the existing `ws://127.0.0.1:16794/websocket/standard` endpoint and maps the
 public `web-print-pdf@2.x` API one-to-one onto MCP tools.
 
+- Website: <https://webprintpdf.com/>
+- Underlying npm package: [web-print-pdf](https://www.npmjs.com/package/web-print-pdf)
+- Docs: <https://webprintpdf.com/docs/>
+
 ```
 Claude / dsh ──stdio──> mcp-web-print-pdf ──ws──> Web Print Expert client ──> printer
 ```
 
-## Installation
+## Prerequisites
 
-Hosts fetch it automatically via `npx -y mcp-web-print-pdf`; no global install is required.
+- Install and start the [Web Print Expert client](https://webprintpdf.com/downloadApp/) (Windows 10/11, macOS 11+, Linux / Kylin / UOS)
+- The client listens on `ws://127.0.0.1:16794/websocket/standard` by default
+- No changes to the client or your frontend code; this MCP just maps the public [web-print-pdf](https://www.npmjs.com/package/web-print-pdf) API onto MCP tools
+- MCP guide: <https://webprintpdf.com/docs/mcp-print/>
 
-For local development:
+## Installation
 
-```bash
-npm install
-```
+Nothing to install. Hosts start it via `npx -y mcp-web-print-pdf`; the first run downloads and caches
+the package.
+
+> To pin a version, append it to the package name, for example `npx -y mcp-web-print-pdf@0.2.3`.
 
 ## Configuration
 
@@ -388,7 +396,7 @@ MCP's stdio channel has a default **10MB** per-message limit (the SDK's `ReadBuf
   the client over WebSocket, bypassing the MCP message limit.
 - Alternatively host the file over HTTP and use `printPdfByUrl` / `printImageByUrl` / `printHtmlByUrl`.
 
-## Coverage vs `web-print-pdf@2.1.9`
+## Coverage vs [web-print-pdf@2.1.9](https://www.npmjs.com/package/web-print-pdf)
 
 | Upstream public API | This MCP |
 |---|---|
@@ -425,6 +433,18 @@ MCP).
   `electronApp/server/websocket/standard/`, option whitelists in `core/generatePdf` and
   `core/printPdf`.
 
+## Local development
+
+```bash
+git clone https://github.com/weixiaoyi/mcp-web-print-pdf.git
+cd mcp-web-print-pdf
+npm install
+npm test
+```
+
+`npm test` runs unit tests for option merging and the default action; the end-to-end smoke test is
+below.
+
 ## Local verification (works without the client)
 
 ```bash
@@ -465,6 +485,15 @@ check that a preview appears.
   `batchPrint` tasks use a `data` field, not the `content` / `url` / `base64` fields shown in the
   `web-print-pdf` README examples.
 
+## Links
+
+- Website: <https://webprintpdf.com/>
+- Docs: <https://webprintpdf.com/docs/>
+- MCP guide: <https://webprintpdf.com/docs/mcp-print/>
+- Client download: <https://webprintpdf.com/downloadApp/>
+- web-print-pdf (npm): <https://www.npmjs.com/package/web-print-pdf>
+- This repository: <https://github.com/weixiaoyi/mcp-web-print-pdf>
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-web-print-pdf",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "MCP server for Web打印专家 / web-print-pdf — full API coverage: HTML, URL, PDF, image, batch printing to local printers",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
     "receipt",
     "label"
   ],
-  "homepage": "https://github.com/weixiaoyi/mcp-web-print-pdf#readme",
+  "homepage": "https://webprintpdf.com/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weixiaoyi/mcp-web-print-pdf.git"