conv2pdf

conv2pdf-mcp

conv2pdf API 的官方 Model Context Protocol 服务。你的 AI 助手可以将 Word、Excel、PowerPoint、Pages、图片、电子书、PostScript 和 HTML 文件转换为 PDF，也可以根据网页地址将网页转换为 PDF；还可以将 PDF 转换为 Word 或图片，并合并、拆分、压缩、保护、旋转或添加页码到你电脑上的 PDF。处理由 OVHcloud 在法国的服务器完成：数据不会传输到欧盟以外，处理链路中不使用美国服务。

安装 · 工具 · 运行方式 · 开发

安装

1. 在 conv2pdf.com 创建账号。Dev 方案包含 300 次免费转换，有效期为 12 个月；付费方案请参阅价格。
2. 在控制面板的 Developer 选项卡中创建一个以 cpdf_live_ 开头的 API 密钥。conv2pdf 只会在创建时显示一次。
3. 将服务添加到 MCP 客户端，并将密钥设为 CONV2PDF_API_KEY 环境变量。需要 Node.js 22 或更高版本。

在 Claude Code 中：

claude mcp add --env CONV2PDF_API_KEY=cpdf_live_... --transport stdio conv2pdf -- npx -y conv2pdf-mcp

在 Windows 上，请在 npx 前加上 cmd /c。

在 Claude Desktop、Cursor 以及其他通过 JSON 文件配置的客户端中：

{
  "mcpServers": {
    "conv2pdf": {
      "command": "npx",
      "args": ["-y", "conv2pdf-mcp"],
      "env": { "CONV2PDF_API_KEY": "cpdf_live_..." }
    }
  }
}

或者，在 Claude Code 中安装插件：它包含同一个服务，以及一个技能，用于告知助手应调用哪个工具、按什么顺序调用，以及每次调用的费用。

/plugin marketplace add jamalofski/conv2pdf-mcp
/plugin install conv2pdf@conv2pdf

启用插件时，Claude Code 会提示你输入 API 密钥，并将其保存在系统的凭据存储中，而不是设置文件里。稍后要设置密钥时，运行 /plugin configure conv2pdf@conv2pdf，或打开 /plugin，进入 Installed 选项卡，选择 conv2pdf，然后选择 Configure options。如果你通过 npx -y conv2pdf-mcp 命令手动添加了服务，则该服务的优先级高于插件中的服务。

对于会加载 SKILL.md 技能的其他 Agent，请按上述方法添加服务，并单独添加该技能：本仓库中的 plugin/skills/conv2pdf/SKILL.md，也可在 Agensi 上找到。

然后告诉助手你需要什么，例如：“将 report.docx 转换为 PDF”、“合并这三个 PDF”、“压缩 scan.pdf 并设置密码保护”。

工具

工具	功能
convert_to_pdf	根据文件扩展名，将 Word、Excel、PowerPoint、OpenDocument、Apple Pages、RTF、TXT、CSV、PNG、JPG、WebP、GIF、TIFF、HEIC、EPUB、PostScript（PS、EPS）或 HTML 文件转换为 PDF
convert_url_to_pdf	根据网址将公开网页转换为 PDF，效果如同在浏览器中打印
convert_heic_to_jpg	将 iPhone 的 HEIC 或 HEIF 照片转换为 JPG
convert_pdf_to_word	将包含真实文本的 PDF 转换为可编辑的 DOCX 文档
convert_pdf_to_images	将每页转换为一张 PNG 或 JPG 图片，并打包为 ZIP 文件
merge_pdfs	按给定顺序将多个 PDF 合并为一个文件
extract_pdf_pages	按列出的顺序，将指定页面（例如 1-5,7,10-12）复制到新的 PDF 中
split_pdf	将 PDF 按页拆分，并打包为 ZIP 文件
rotate_pdf	将每页旋转 90、180 或 270 度
add_page_numbers	在页面底部居中、靠左或靠右的位置添加页码，例如“3 / 12”或“3”
add_watermark	在每页加盖一段不超过 50 个字符的文字
compress_pdf	缩小文件体积，图像分辨率可设为 72、150 或 300 DPI
protect_pdf	设置密码，也可选择禁止打印或复制
unlock_pdf	移除你知道的密码，或解除打印和复制限制
get_quota	查询 API 密钥对应的方案、用量和限额

工作原理

• 除转换过程外，文件始终留在你的电脑上。 工具会接收文件路径，将文件发送到 conv2pdf，并将结果写入你的磁盘。conv2pdf 会检查文件内容，而不只是文件名。
• 不会覆盖任何文件。 结果会写在输入文件旁边：report.docx 会生成 report.pdf，PDF 工具则会添加后缀，例如 report-compressed.pdf。如果该名称已被占用，服务会写入 report (2).pdf。助手可以通过 output_path 选择保存位置；如果该位置已有文件，工具会在转换前拒绝操作。网页没有可供写入其旁边的输入文件，因此 convert_url_to_pdf 始终需要 output_path。
• 从服务端删除。 结果写入你的磁盘后，服务会从 conv2pdf 删除该任务。如果删除失败，conv2pdf 会在一小时后删除文件。
• 配额。 每次转换都会计入套餐配额，包括 conv2pdf 读取文件后拒绝转换的情况，例如文件无法读取、PDF 是扫描件或页数过多。文件到达时就被拒绝（类型错误、文件过大、缺少密码）、设置被拒绝（页码范围不存在、密码太短）以及 conv2pdf 端发生故障，都不计入配额；get_quota 则免费。Dev 套餐的文件大小上限为 10 MB，付费套餐为 200 MB。
• 速率限制。 API 对每个 API 密钥每分钟最多接受 20 次转换。如果 API 要求减慢速度，或队列已满，服务会等待 API 给出的时长后重试，最多重试两次，且仅在等待时长不超过 30 秒时重试；否则，助手会收到需要等待的时长。
• 受保护的 PDF。 读取 PDF 的工具（merge_pdfs 除外）可以打开需要密码的 PDF，前提是助手通过 password 传入密码。结果不带密码。合并受保护的 PDF 时，请先解锁它们。
• Pages 和 Numbers。 Pages 文档会保留 .pages 扩展名：只有名称能将它与 Numbers 电子表格区分开来，而 conv2pdf 不会转换 Numbers 电子表格，Keynote 演示文稿也一样。
• 错误。 拒绝操作时，助手会收到可以据此采取行动的说明，例如密码错误、页码范围不存在、套餐限制或需要设置的密钥。取消调用会停止传输，且不会留下文件。
• 不使用密钥。 服务会启动并列出其工具；调用时会说明如何设置 CONV2PDF_API_KEY。

每个请求都会携带 User-Agent: conv2pdf-mcp/<version>。联系支持团队时请提及它，这样他们就能在 API 日志中区分你的调用。

开发

服务没有依赖项：Node.js 会直接运行源代码。它通过 stdio 与客户端通信，并在同一进程中支持两个时期的协议：修订版 2026-07-28 中，每个请求都会携带协议版本；更早的修订版（从 2025-11-25 到 2024-11-05）则以 initialize 握手开始。

npm test

会在本地端口上使用模拟的 conv2pdf API 运行测试：无需密钥，也无需联网。

npm run check-tools

会将扩展支持的 convert_to_pdf 路由与实时 API 接受的路由（GET /v1/tools）进行比对。

插件

plugin/ 存放 Claude Code 插件：其中包括清单、通过 npx 启动已发布软件包的 .mcp.json，以及技能文件 plugin/skills/conv2pdf/SKILL.md。.claude-plugin/marketplace.json 是目录文件，可让 Claude Code 从此存储库安装插件。两者都不属于 npm 软件包的一部分。npm test 会检查插件版本是否与软件包版本一致，以及技能是否列出了服务提供的工具。

claude plugin validate . --strict
claude --plugin-dir ./plugin

会检查清单，然后在不安装插件的情况下，从该文件夹加载插件并启动会话。插件或技能有变更时，用户会在版本变更后获取更新：它们随发布版本一起提供。

发布

1. 在 package.json、server.json 和 plugin/.claude-plugin/plugin.json 中设置版本，并在 CHANGELOG.md 中为相应章节标注日期。
2. 运行 npm test 和 npm run check-tools。
3. 提交，然后推送一个以版本号命名的标签：Publish 工作流会通过 Trusted Publishing 将软件包发布到 npm，并附带来源声明。
4. 发布 MCP Registry 条目：运行 mcp-publisher login http --domain conv2pdf.com，然后运行 mcp-publisher publish。名称 com.conv2pdf/conv2pdf 由托管在 https://conv2pdf.com/.well-known/mcp-registry-auth 的公钥验证。
5. 如果技能有变更，请将其作为新版本重新上传到 Agensi 列表：上传一个包含 SKILL.md 的 conv2pdf/ 文件夹的 ZIP 文件。此仓库不会更新该列表。

资源

• conv2pdf API 文档
• Agensi 上的 conv2pdf 技能
• 模型上下文协议规范

支持

请提交 issue，或发送邮件至 [email protected]。

许可证

MIT，详见 LICENSE。