Papyrio PDF Tools

papyrio-mcp

用于 Papyrio PDF API 的 MCP 服务。为 Claude、Cursor 和 VS Code 配置：papyrio.net/mcp。它可让 助手在你的本机上压缩、合并、OCR 识别和转换 PDF，并读取和写入本地文件，因此多步处理无需每一步都上传和下载文件。

OCR every scan in ~/invoices, merge them into one PDF, compress it under 5 MB

这是助手自行发起的四次工具调用。

安装

一键安装 Claude Desktop

下载 papyrio-mcp.mcpb 并双击。Claude Desktop 会打开安装界面；免费访客套餐可将 API 密钥留空，也可以粘贴 RapidAPI 密钥（见下文）。之后可在“设置”中的“扩展”里修改。

手动安装或用于其他客户端

将以下内容添加到 Claude Desktop 配置中：

macOS ~/Library/Application Support/Claude/claude_desktop_config.json Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"]
    }
  }
}

重启 Claude Desktop。工具会显示在连接器图标下。

API 密钥

无需密钥即可使用服务，按普通免费网络流量计费：每个 IP 地址每天可执行三次操作。足以让你了解它是否实用。

如需正式使用，请在 RapidAPI 上订阅并提供密钥：

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"],
      "env": { "PAPYRIO_API_KEY": "your-rapidapi-key" }
    }
  }
}

RapidAPI 免费套餐每月提供 50 次请求，无需绑定银行卡。

工具

工具	功能	写入文件
compress_pdf	压缩 PDF；对于图片较多的文件，体积可缩小 30–80%	.pdf
merge_pdfs	按顺序合并 2–10 个 PDF	.pdf
split_pdf	将每一页拆分为单独的文件	.zip
extract_pdf_text	以 UTF-8 格式返回文本层	.txt
pdf_to_word	将文档重建为可编辑的 .docx 文件	.docx
pdf_to_jpg	将每一页渲染为 JPG	.zip
ocr_pdf	为扫描件添加可搜索的文本层；lang 可选择英语、俄语、西班牙语、意大利语、乌兹别克语或哈萨克语	.pdf
office_to_pdf	将 Word、PowerPoint 或 Excel 转换为 PDF	.pdf
image_to_pdf	将 JPG、PNG 或 WebP 封装为 PDF 页面	.pdf
webpage_to_pdf	在无头浏览器中渲染公开 URL	.pdf
protect_pdf	使用 AES-256 加密	.pdf
unlock_pdf	移除你已知密码的保护	.pdf

所有工具都接受绝对路径。output_path 为可选参数，默认使用输入文件名并添加 -papyrio 后缀；但 webpage_to_pdf 没有可用于生成文件名的输入文件，因此必须指定该参数。

添加工具

在 src/tools.ts 中添加一条目。MCP 工具、输入架构和 HTTP 调用都会由此自动生成。

测试

npm run build
PAPYRIO_API_KEY=your-key node smoke.mjs

通过真实 MCP 协议对接在线 API，驱动全部十二种工具，并检查返回文件的魔数；因此，命名为 .pdf 的 JSON 错误响应会被判定为失败，而非通过。未提供密钥时会使用访客套餐运行，每天三次操作意味着大多数测试用例都会遇到 rate_limit_exceeded。

开发

npm install
npm run build

开发时，将配置指向本地构建：

{
  "mcpServers": {
    "papyrio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

隐私：文件会发送到 Papyrio API，在内存中处理，并在响应发送后丢弃。不会存储任何内容。

许可证

MIT