PDF4me

PDF4me MCP 服务

PDF4me MCP 服务通过 Model Context Protocol (MCP) 提供 PDF4me API 功能，让 AI 助手能够轻松执行各种 PDF、文档、图像和条形码处理任务。

---

🚀 主要功能

📄 PDF 转换

• PDF → Office：将 PDF 转换为 Word (DOCX)、Excel (XLSX)、PowerPoint (PPTX)
• PDF → 其他格式：将 PDF 转换为 PDF/A、可搜索的 OCR PDF、HTML、Markdown
• Office → PDF：将 DOCX、PPTX、XLSX、CSV、HTML、Markdown、Visio 和图像转换为 PDF
• Word → PDF 表单：将 Word 文档转换为可填写的 PDF 表单
• JSON → Excel：将 JSON 数据文件转换为 Excel 工作簿

🛠️ PDF 编辑与修改

• 印章与水印：向 PDF 添加文本或图像印章/水印
• 页眉与页脚：插入基于 HTML 的页眉和页脚
• 批注：添加页码、边距和超链接批注
• 附件：将任意文件作为附件嵌入 PDF
• 签名：将签名图像应用到 PDF 页面
• 查找与替换：搜索并替换文本，或将文本替换为图像

📐 PDF 整理

• 合并：合并多个 PDF，或叠加两个 PDF
• 拆分：按页面、页码范围、条形码、Swiss QR 码或匹配文本拆分
• 删除 / 提取：移除或提取指定页面，删除空白页面
• 旋转：旋转 PDF 的所有页面或指定页面

🔍 PDF 提取与分析

• 表单数据：从可填写的 PDF 表单字段中提取值
• 表格：检测并提取带坐标的表格
• 文本：使用正则表达式提取文本；查找并替换文本
• 附件：从 PDF 中提取嵌入的文件附件
• 资源：从 PDF 内容中提取文本和图像
• 分类：根据文档类型、类别和置信度对 PDF 分类

🤖 AI 文档处理

• 发票、订单、收据：使用 AI 提取结构化数据
• 银行对账单与支票：自动解析金融文档
• 合同与抵押贷款文档：提取法律文档中的关键字段
• 税务文档与工资单：解析税表和工资单文档
• 身份证件与卡片：处理医保卡、信用卡、结婚证和运输标签
• 通用提取：从任意类型的文档中使用 AI 提取通用数据

🏷️ 条形码与 QR 码

• 创建：生成条形码和 QR 码 (PNG)
• 添加到 PDF：将条形码或 QR 码盖印到 PDF 页面上
• 从 PDF / 图像读取：检测并解码条形码和 QR 码
• Swiss QR 账单：创建和读取 Swiss QR 账单付款部分；按 Swiss QR 拆分 PDF

🖼️ 图像处理

• 格式转换：在 BMP、GIF、JPG、PNG、TIFF 之间转换
• 编辑：调整图像大小、旋转、翻转和裁剪
• 水印：向图像添加图像或文本水印
• OCR：使用 OCR 从图像中提取文本
• 元数据：读取或清除 EXIF 元数据
• 压缩：按可配置的质量等级压缩图像

📝 Word 与文档工具

• 修订跟踪：启用、禁用或提取 Word 文档中的修订
• 将文本替换为图像：在 Word 文档中用图像替换文本占位符
• 提取文本：从 Word 文档中提取文本，并可控制是否包含页眉、页脚和批注

📦 文档生成

• 单个文档：根据模板和数据 (JSON、XML 或纯文本) 生成一个文档
• 批量文档：根据单个模板和数据集生成多个文档

🔒 安全

• 保护 PDF：应用密码保护，并可配置权限
• 解锁 PDF：移除 PDF 的密码保护
• ZUGFeRD 发票：创建符合标准的 ZUGFeRD 电子发票 (XML 或 PDF+XML)

⚙️ 实用工具

• 上传文件：将本地文件上传到 PDF4me 云存储
• PDF 元数据：读取完整元数据（标题、作者、页数、安全信息、日期）
• 图像元数据：读取图像属性和 EXIF 字段
• 修复 PDF：修复损坏或格式错误的 PDF
• 优化 PDF：压缩、线性化（针对网页优化）或扁平化 PDF

---

⚙️ 配置

🔑 获取 API 密钥

1. 在 dev.pdf4me.com 注册
2. 从控制面板获取 API 密钥

📦 安装 UV

运行此 MCP 服务需要使用 UV（一款快速的 Python 打包工具）。

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

其他方法

# Homebrew (macOS)
brew install uv

# pipx
pipx install uv

# pip
pip install uv

如需了解更多选项，请参阅 UV 安装指南。

---

🔧 MCP 客户端设置

Cursor

打开 Cursor 设置 → MCP，或编辑 ~/.cursor/mcp.json（macOS/Linux）/ %USERPROFILE%\.cursor\mcp.json（Windows）：

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

打开 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

打开 ~/.config/Code/User/mcp.json（macOS/Linux）或 %APPDATA%\Code\User\mcp.json（Windows）：

{
  "servers": {
    "pdf4me-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue（VS Code / JetBrains 扩展）

添加到 ~/.continue/config.json：

{
  "mcpServers": [
    {
      "name": "pdf4me-mcp",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  ]
}

---

🪟 Windows 注意事项

在 Windows 上，如果 uvx 不在 PATH 中，可能需要使用其完整路径调用。将 "command": "uvx" 替换为完整路径，例如：

"command": "C:\\Users\\<YourUser>\\.local\\bin\\uvx"

---

🛠️ 可用工具

🏷️ 条码工具

工具	描述
add_barcode_to_pdf	在 PDF 页面上绘制条码或 QR 码，并可配置对齐方式和大小
create_barcode	生成条码或 QR 码 PNG 图像（支持 Code128、QR 等）
read_barcodes	从本地 PDF 中读取并解码条码/QR 数据，并可按条码类型和页面筛选
read_barcodes_from_image	从本地图像文件中检测并解码条码和 QR 码
create_swiss_qr_bill	向 PDF 添加瑞士 QR 账单付款部分（IBAN、债权人详情、货币、参考信息）
read_swiss_qr_bill	解析并提取本地 PDF 中的瑞士 QR 账单付款数据
split_pdf_by_barcode	在包含特定条码值或类型的页面处分割 PDF，生成多个文件
split_pdf_by_swiss_qr	按瑞士 QR 码的位置将 PDF 分割为单独的 PDF 文件或 ZIP 压缩包

---

🔄 转换工具

工具	描述
convert_to_pdf	将文档（DOCX、PPTX、XLSX、图像和文本格式）转换为 PDF
convert_html_to_pdf	将本地 HTML 文件转换为 PDF，并设置布局、边距和打印选项
convert_url_to_pdf	将网页 URL 转换为 PDF，并设置身份验证、布局和边距
convert_md_to_pdf	将本地 Markdown 文件转换为 PDF
convert_visio_to_pdf	将 Visio 文件（.vsdx/.vsd/.vsdm）转换为 PDF
convert_word_to_pdf_form	将 Word 文档（DOCX）转换为可填写的 PDF 表单
convert_pdf_to_word	将 PDF 转换为 DOCX，并设置质量、语言和可选的 OCR
convert_pdf_to_excel	将 PDF 转换为 XLSX，并设置质量、工作表合并、语言和可选的 OCR
convert_pdf_to_powerpoint	将 PDF 转换为 PPTX，并设置质量、语言和可选的 OCR
convert_pdf_to_pdfa	将 PDF 转换为 PDF/A（PdfA1a 至 PdfA3u），并控制升级或降级
convert_ocr_pdf	对扫描版 PDF 运行 OCR 并嵌入文本层，使其可搜索
convert_json_to_excel	将本地 JSON 文件转换为 Excel 工作簿（XLSX），并设置工作表名称和标题选项
convert_image_format	在 BMP、GIF、JPG、PNG 和 TIFF 格式之间转换图像
flatten_pdf	扁平化 PDF（将表单字段和注释合并到页面内容中）
linearize_pdf	对 PDF 进行线性化（针对网页优化），以便浏览器快速加载，并可配置优化预设

---

✏️ PDF 编辑工具

工具	描述
add_attachment_to_pdf	将一个或多个文件作为附件嵌入 PDF
add_html_header_footer_to_pdf	为 PDF 页面添加 HTML 格式的页眉、页脚或两者
add_margin_to_pdf	为 PDF 的所有页面添加页边距（单位为毫米）
add_page_number_to_pdf	插入页码，并可配置对齐方式、格式和字体样式
add_image_stamp_to_pdf	在 PDF 页面上放置图像印章或水印，并控制对齐方式、不透明度和尺寸
add_text_stamp_to_pdf	在 PDF 页面上放置文本印章或水印，并设置字体、不透明度、旋转和对齐方式
sign_pdf	将签名图像应用到 PDF，并设置布局和边距
find_and_replace_text	查找并替换 PDF 页面中的文本
replace_text_with_image	将 PDF 中匹配的文本替换为图像，并可配置图像尺寸
update_hyperlink_annotation	根据搜索条件更新或替换 PDF 中的超链接注释
repair_pdf	修复损坏或格式异常的 PDF 文件

---

📤 提取工具

工具	描述
extract_pages_from_pdf	从 PDF 中提取指定页面并保存为新 PDF 文件
extract_form_data_from_pdf	提取 PDF 中所有表单字段的名称及其当前值
extract_attachment_from_pdf	提取 PDF 中嵌入的文件附件并保存到磁盘
extract_resources	提取 PDF 中嵌入的文本内容和图像
extract_table_from_pdf	检测并提取 PDF 中的表格，将结果保存为 JSON 和 CSV
extract_text_by_expression	使用正则表达式模式从 PDF 中提取文本
extract_text_from_word	从 Word 文档中提取文本，并可选择移除页眉、页脚或批注
extract_text_from_image	使用 OCR 从图像中提取文本
classify_document	按文档类型和类别对 PDF 进行分类，并提供置信度分数
parse_document	使用预定义的 PDF4me 解析模板从 PDF 中提取结构化数据

---

📋 表单工具

工具	描述
add_form_fields_to_pdf	在指定坐标处向 PDF 添加新的 TextBox 或 CheckBox 表单字段
fill_pdf_form	使用键值数据映射填写 PDF 中现有的表单字段

---

📝 文档生成工具

工具	描述
generate_document_single	使用模板（DOCX/HTML/PDF）和数据载荷（JSON/XML/文本）生成一份文档
generate_documents_multiple	使用一个模板和多条记录的数据集批量生成多份文档
enable_tracking_changes_in_word	在 Word 文档中启用修订模式
disable_tracking_changes_in_word	在 Word 文档中禁用修订模式
get_tracking_changes_in_word	从 Word 文档中提取所有修订数据，并以结构化 JSON 格式返回
replace_text_with_image_in_word	在 Word 文档中用图像替换文本占位符

---

🖼️ 图像工具

工具	描述
add_image_watermark_to_image	将水印图像叠加到另一张图像上，并可控制不透明度和位置
add_text_watermark_to_image	为图像添加文本水印，并可设置字体、颜色、不透明度和旋转选项
compress_image	使用可配置的压缩级别压缩 JPG、PNG 或 WebP 图像
convert_image_format	在 BMP、GIF、JPG、PNG 和 TIFF 格式之间转换图像
create_images_from_pdf	将 PDF 页面渲染为图像文件（JPEG、PNG、TIFF），并可选择页面和宽度
crop_image	按边框或指定矩形区域裁剪图像
flip_image	水平或垂直翻转图像
get_image_metadata	提取 JPG 或 PNG 文件的图像属性和 EXIF 元数据
extract_text_from_image	对图像运行 OCR 以提取其中的文本内容
resize_image	按百分比或指定尺寸调整图像大小，并可控制宽高比
rotate_image	按指定角度旋转图像，并可设置背景颜色和调整大小选项
rotate_image_by_exif_data	根据图像的 EXIF 元数据自动旋转图像至正确方向
remove_exif_tags_from_image	清除 JPG 或 PNG 图像中的所有 EXIF 元数据

---

🔗 合并与拆分工具

工具	描述
merge_multiple_pdfs	将两个或多个 PDF 文件合并为一个 PDF
merge_pdf_overlay	将一个 PDF 叠加到另一个 PDF 上（例如，添加信头）
split_pdf	按页码、重复间隔、序列或页码范围拆分 PDF
split_pdf_by_barcode	在包含指定条形码的页面处拆分 PDF
split_pdf_by_swiss_qr	在瑞士 QR 码位置拆分 PDF
split_pdf_by_text	在包含指定文本字符串的页面处拆分 PDF

---

⚡ 优化工具

工具	描述
compress_pdf	使用针对 Web、Print 或 Screen 的优化配置文件压缩 PDF
delete_blank_pages_from_pdf	从 PDF 中移除空白页（无文本、无图像或两者皆无）
linearize_pdf	对 PDF 进行线性化，以便在 Web 浏览器中快速增量加载

---

📂 整理工具

工具	描述
delete_pdf_pages	按页码或范围从 PDF 中移除指定页面
extract_pages_from_pdf	将选定页面从 PDF 中提取到新文件
rotate_pdf	旋转 PDF 的所有页面（顺时针、逆时针、倒置）
rotate_pdf_page	分别旋转选定的 PDF 页面

---

📊 PDF 信息工具

工具	描述
get_pdf_metadata	读取完整的 PDF 元数据：标题、作者、页数、安全信息和日期
get_image_metadata	读取 JPG 或 PNG 的图像属性和可用 EXIF 字段
repair_pdf	尝试修复损坏或格式错误的 PDF

---

🔒 安全工具

工具	描述
protect_pdf	使用可配置的权限（打印、复制、编辑等）为 PDF 设置密码保护
unlock_pdf	使用当前密码移除 PDF 的密码保护

---

🤖 AI 文档处理工具

工具	描述
process_invoice	使用 AI 从 PDF 或图像中提取结构化发票数据（明细项目、总额、日期、供应商信息）
process_bank_cheque	使用 AI 解析银行支票图像并提取支票详情
process_contract	使用 AI 从合同文档中提取关键条款和字段
process_credit_card	使用 AI 从银行卡图像中提取信用卡信息
process_health_card	使用 AI 从医疗保险卡图像中提取数据
process_marriage_certificate	使用 AI 从结婚证中提取字段，并可选择验证真伪
process_mortgage_document	使用 AI 从抵押贷款文档中提取关键财务和房产详情
process_pay_stub	使用 AI 从工资单文档中提取收入、扣款和员工详情
process_bank_statement	使用 AI 解析银行对账单中的交易、余额和模式
process_order	使用 AI 从采购订单文档中提取订单详情（商品、数量、价格、地址）
process_receipt	使用 AI 从收据图像或 PDF 中提取商家信息、明细项目和总额
process_shipping_label	使用 AI 从运输标签中提取承运商、追踪号码和地址数据
process_tax_document	使用 AI 从税务文档中提取税表字段和计算得出的数值
process_universal_document	使用 AI 从任何类型的文档中提取指定字段（字段列表可配置）

---

📜 ZUGFeRD / 电子发票工具

工具	描述
create_zugferd_invoice	根据 XML、JSON 或 CSV 数据创建符合 ZUGFeRD 标准的电子发票，可输出为 PDF+XML 或仅 XML

---

🗂️ 文件管理工具

工具	描述
upload_file	将本地文件上传到 PDF4me 云存储，并获取用于后续操作的文件引用
get_document_from_pdf4me	注册 Webhook 回调 URL，以接收来自 PDF4me 的文档

---

💡 使用示例

将 PDF 转换为 Word：

Convert this PDF to a Word document: /path/to/document.pdf

合并多个 PDF：

Merge these PDFs into one: report.pdf, appendix.pdf, cover.pdf

使用 AI 提取发票数据：

Extract all invoice details from this file: invoice.pdf

向 PDF 添加瑞士 QR 账单：

Add a Swiss QR Bill to invoice.pdf with IBAN CH93-0076-2011-6238-5295-7, creditor name "Acme AG"

按条形码拆分 PDF：

Split this PDF at every page containing a Code128 barcode: batch.pdf

根据模板生成文档：

Generate a contract PDF from contract_template.docx with this data: {"client": "ACME", "date": "2024-01-01"}

压缩图像：

Compress this PNG image with maximum compression: photo.png

对扫描版 PDF 进行 OCR：

Make this scanned PDF searchable: scanned_report.pdf

---

🛠️ 手动运行（不使用客户端）

uvx pdf4me-mcp

或者，如果已在本地安装：

PDF4ME_API_KEY=your-api-key-here pdf4me-mcp

---

📞 支持与联系

• PDF4me：pdf4me.com
• API 文档：docs.pdf4me.com
• 问题报告：GitHub 问题

---

📄 许可证

本项目根据 MIT 许可证发布。