Pdfco MCP

🚀 PDF.co MCP

PDF.co MCP Server 通過模型上下文協議（MCP）提供 PDF.co API 功能，使AI助手能夠輕鬆執行各種PDF處理任務。

🚀 快速開始

要使用此MCP服務器，你需要完成以下配置步驟：

🔑 獲取API密鑰

1. 在 PDF.co網站 上註冊賬號。
2. 從儀表盤獲取你的API密鑰。

📦 安裝UV

你需要安裝UV（一個快速的Python打包工具）來使用這個MCP服務器：

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
• 使用PyPI和pipx：pipx install uv
• 使用PyPI和pip：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桌面配置

在你的 claude_desktop_config.json 文件中添加以下內容：

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

✨ 主要特性

📄 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文件轉換為CSV、JSON、HTML、TXT、XML、PDF

🛠️ PDF編輯與修改

• PDF合併：將多個PDF文件合併為一個
• PDF拆分：按特定頁面或頁面範圍拆分PDF
• 添加註釋和圖像：向PDF中添加文本、鏈接、圖像、形狀
• 表單操作：讀取PDF表單字段信息、填寫表單、創建新的表單元素

🔍 PDF搜索與分析

• 文本搜索：在PDF中搜索文本（支持正則表達式）
• 表格檢測：查找PDF中表格的位置和座標
• AI發票解析器：使用AI提取發票數據
• PDF信息：獲取詳細信息，包括元數據、頁面數量、安全信息

🔒 安全與可訪問性

• 密碼保護：為PDF添加/移除密碼保護
• 可搜索性：通過OCR使PDF可搜索或移除文本層
• 附件提取：從PDF中提取附件

💼 文件管理

• 文件上傳：將本地文件上傳到PDF.co服務器
• 任務狀態跟蹤：監控異步操作的進度和結果

🔧 可用工具

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轉換工具

• excel_to_csv：將Excel（XLS、XLSX）轉換為CSV
• excel_to_json：將Excel（XLS、XLSX）轉換為JSON
• excel_to_html：將Excel（XLS、XLSX）轉換為HTML
• excel_to_txt：將Excel（XLS、XLSX）轉換為TXT
• excel_to_xml：將Excel（XLS、XLSX）轉換為XML
• 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：檢查任務的狀態和結果。狀態可以是：正在處理、成功、失敗、中止或未知
• wait_job_completion：等待任務完成

💻 使用示例

將PDF轉換為文本

將此PDF文件轉換為文本：https://example.com/document.pdf

將多個圖像合併為PDF

從這些圖像創建一個PDF：image1.jpg, image2.png, image3.jpg

在PDF中搜索特定文本

在這個PDF文檔中查找單詞 "contract"

填寫PDF表單字段

在這個PDF表單的姓名字段中填寫 "John Doe"

將網頁轉換為PDF

將https://example.com網頁轉換為PDF

提取發票數據

使用AI從這個PDF中提取發票信息

添加密碼保護

為這個PDF文件添加密碼保護

📞 支持與聯繫

• PDF.co：https://pdf.co
• PDF.co API文檔：https://developer.pdf.co
• 問題報告：請通過GitHub Issues報告問題

📄 許可證

本項目根據MIT許可證進行分發。

⚠️ 重要提示

使用此工具需要有效的PDF.co API密鑰。請在 PDF.co 上創建一個免費賬戶以獲取API密鑰。