PDF.co

PDF.co MCP

PDF.co MCP 服务通过模型上下文协议（MCP）提供 PDF.co API 功能，让 AI 助手轻松执行各种 PDF 处理任务。

🚀 主要功能

📄 PDF 转换工具

• PDF → 各种格式：将 PDF 转换为 JSON、CSV、文本、Excel（XLS/XLSX）、XML、HTML、图像（JPG/PNG/WebP/TIFF）
• 各种格式 → PDF：将文档（DOC/DOCX/RTF/TXT）、电子表格（CSV/XLS/XLSX）、图像、网页、HTML、电子邮件（MSG/EML）转换为 PDF
• Excel 转换：将 Excel 文件转换为 PDF

🛠️ PDF 编辑与修改

• 合并 PDF：将多个 PDF 文件合并为一个
• 拆分 PDF：按指定页面或页码范围拆分 PDF
• 添加注释和图像：向 PDF 添加文本、链接、图像、形状
• 表单操作：读取 PDF 表单字段信息、填写表单、创建新的表单元素

🔍 PDF 搜索与分析

• 文本搜索：在 PDF 中搜索文本（支持正则表达式）
• 表格检测：查找 PDF 中表格的位置和坐标
• AI 发票解析器：使用 AI 提取发票数据
• PDF 信息：获取详细信息，包括元数据、页数、安全信息

🔒 安全性与无障碍功能

• 密码保护：为 PDF 添加或移除密码保护
• 可搜索性：通过 OCR 使 PDF 可搜索，或移除文本图层
• 附件提取：从 PDF 中提取附件

💼 文件管理

• 文件上传：将本地文件上传到 PDF.co 服务器
• 任务状态跟踪：监控异步操作的进度和结果

⚙️ 配置

🔑 获取 API Key

1. 在 PDF.co 网站 注册
2. 从控制面板获取 API Key

📦 安装 UV

使用此 MCP 服务需要安装 UV（一款快速的 Python 包管理工具）：

macOS 和 Linux

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

Windows

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

其他安装方式

• Homebrew：brew install uv
• 通过 pipx 使用 PyPI：pipx install uv
• 通过 pip 使用 PyPI：pip install uv

如需了解其他安装选项和详情，请参阅 UV 安装指南。

MCP 服务设置

Cursor IDE 配置

将以下内容添加到 .cursor/mcp.json 文件中：

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Desktop 配置

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🔧 可用工具

PDF 转换工具

• pdf_to_json：将 PDF 和扫描图像转换为 JSON 表示形式，并保留文本、字体、图像、矢量图和格式
• pdf_to_csv：将 PDF 和扫描图像转换为 CSV，并保留布局、列、行和表格
• pdf_to_text：将 PDF 和扫描图像转换为文本，并保留布局
• pdf_to_xls：将 PDF 和扫描图像转换为 XLS（Excel 97-2003）格式
• pdf_to_xlsx：将 PDF 和扫描图像转换为 XLSX（Excel 2007 及更高版本）格式
• pdf_to_xml：将 PDF 和扫描图像转换为 XML 格式
• pdf_to_html：将 PDF 和扫描图像转换为 HTML 格式
• pdf_to_image：将 PDF 和扫描图像转换为各种图像格式（JPG、PNG、WebP、TIFF）

文档转 PDF 工具

• document_to_pdf：将各种文档类型（DOC、DOCX、RTF、TXT、XLS、XLSX、CSV、HTML、JPG、PNG、TIFF、WEBP）转换为 PDF
• csv_to_pdf：将 CSV 或电子表格文件（XLS、XLSX）转换为 PDF
• image_to_pdf：将各种图像格式（JPG、PNG、TIFF）转换为 PDF
• webpage_to_pdf：将外部网页 URL 转换为 PDF
• html_to_pdf：将 HTML 转换为 PDF
• email_to_pdf：将电子邮件转换为 PDF

Excel 转换工具

退役通知 — 2027 年 1 月 5 日

以下 Excel 转换工具计划于 2027 年 1 月 5 日退役，原因是其底层 PDF.co API 端点将停止服务：excel_to_csv、excel_to_json、excel_to_html、excel_to_txt、excel_to_xml。这些工具将持续可用，直至退役日期。2027 年 1 月 5 日之后，将不再支持对其底层 API 端点的请求。excel_to_pdf 不受影响。

• excel_to_csv：将 Excel（XLS、XLSX）转换为 CSV（将于 2027 年 1 月 5 日退役）
• excel_to_json：将 Excel（XLS、XLSX）转换为 JSON（将于 2027 年 1 月 5 日退役）
• excel_to_html：将 Excel（XLS、XLSX）转换为 HTML（将于 2027 年 1 月 5 日退役）
• excel_to_txt：将 Excel（XLS、XLSX）转换为 TXT（将于 2027 年 1 月 5 日退役）
• excel_to_xml：将 Excel（XLS、XLSX）转换为 XML（将于 2027 年 1 月 5 日退役）
• excel_to_pdf：将 Excel（XLS、XLSX）转换为 PDF

PDF 编辑工具

• pdf_add_annotations_images_fields：添加文本、图像、表单、其他 PDF、填写表单，以及指向外部网站和外部 PDF 文件的链接。你可以更新或修改 PDF 和扫描版 PDF 文件
• pdf_merge：将两个或更多 PDF、DOC、XLS、图像文件，甚至包含文档和图像的 ZIP 文件合并为一个新的 PDF
• pdf_split：使用页面索引或页面范围将一个 PDF 拆分为多个 PDF 文件

PDF 表单工具

• read_pdf_forms_info：从输入的 PDF 文件中提取可填写 PDF 字段的信息
• fill_pdf_forms：填写 PDF 文档中的现有表单字段
• create_fillable_forms：在 PDF 文档中创建新的可填写表单元素

PDF 搜索工具

• find_text：在 PDF 中查找文本并获取其坐标。支持正则表达式
• find_table：查找 PDF 中的表格并获取其坐标

PDF 分析工具

• ai_invoice_parser：AI 发票解析器：使用 AI 提取发票数据
• extract_attachments：从源 PDF 文件中提取附件
• pdf_info_reader：获取 PDF 文档的详细信息，包括页数、元数据、安全性、表单字段等

PDF 安全工具

• pdf_add_password：为 PDF 文件添加密码保护
• pdf_remove_password：移除 PDF 文件的密码保护

PDF 可搜索性工具

• pdf_make_searchable：将扫描版 PDF 文档或图像文件转换为可搜索文本的 PDF。运行 OCR 并添加可用于文本搜索的不可见文本层
• pdf_make_unsearchable：移除文本层，使现有 PDF 文档无法搜索

文件管理工具

• upload_file：将文件上传到 PDF.co API
• get_job_check：检查任务的状态和结果。状态可以是：working、success、failed、aborted 或 unknown
• wait_job_completion：等待任务完成

📖 使用示例

将 PDF 转换为文本

Convert this PDF file to text: https://example.com/document.pdf

将多张图像合并为 PDF

Create a PDF from these images: image1.jpg, image2.png, image3.jpg

在 PDF 中搜索特定文本

Find the word "contract" in this PDF document

填写 PDF 表单字段

Fill the name field in this PDF form with "John Doe"

将网页转换为 PDF

Convert https://example.com webpage to PDF

提取发票数据

Extract invoice information from this PDF using AI

添加密码保护

Add password protection to this PDF file

📞 支持与联系

• PDF.co：https://pdf.co
• PDF.co API 文档：https://developer.pdf.co
• 问题报告：请通过 GitHub Issues 报告问题

📄 许可证

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

---

注意：使用此工具需要有效的 PDF.co API 密钥。请在 PDF.co 创建免费账户以获取 API 密钥。