PDF.co

io.github.pdfdotco由 GitHub 账号 pdfdotco 发布v0.0.11更新于 Oct 29, 2026

Official PDF.co MCP server: convert, merge, split, OCR, search and fill PDFs through the PDF.co API

已验证STDIO仅桌面文件与存储数据与分析

概览

AI 生成的概览

PDF.co 官方 MCP 服务器，让助手通过 PDF.co API 转换、合并、拆分、OCR、搜索、填写和加密 PDF。

可以做什么
  • 将 PDF 和扫描图片转换为 JSON、CSV、文本、XLS/XLSX、XML、HTML 或图片
  • 将文档、表格、图片、HTML、网页和邮件转换为 PDF
  • 合并、拆分 PDF，并添加文字、图片、链接或表单字段
  • 读取、填写和创建 PDF 表单字段；按坐标查找文字和表格
  • 运行 OCR 使扫描件可搜索，添加或移除密码，读取 PDF 信息并提取附件
  • 上传文件，并查询或等待异步任务状态
适用场景
适合助手需要处理 PDF 和办公文档的场景：提取文字或表格、格式互转、合并或拆分文件、填写表单，或让扫描件可检索。适用于文档密集、原本需要手动调用 PDF.co API 的工作流程。
运行要求
通过 uvx 以 stdio 在本地运行，需要安装 Python 和 uv 工具。需要 PDF.co 账号，并在 X_API_KEY 环境变量中提供 API 密钥。需要访问 PDF.co API 的网络连接，文件会上传到 PDF.co 服务器处理。
安装前请注意
处理的文档和图片会上传到 PDF.co 服务器，机密材料请先确认其条款。X_API_KEY 中的 API 密钥是可计费凭证，使用可能产生 PDF.co 费用。多个工具会修改文档（合并、拆分、填表、增删密码、移除文字层），请核对输出结果。五个 Excel 转换工具计划于 2027 年 1 月 5 日停用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PDF.co，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

PDF.co MCP

PDF.co MCP Server provides PDF.co API functionality through the Model Context Protocol (MCP), enabling AI assistants to easily perform various PDF processing tasks.

🚀 Key Features

📄 PDF Conversion Tools

  • PDF → Various Formats: Convert PDFs to JSON, CSV, Text, Excel (XLS/XLSX), XML, HTML, Images (JPG/PNG/WebP/TIFF)
  • Various Formats → PDF: Convert documents (DOC/DOCX/RTF/TXT), spreadsheets (CSV/XLS/XLSX), images, web pages, HTML, emails (MSG/EML) to PDF
  • Excel Conversions: Convert Excel files to PDF

🛠️ PDF Editing & Modification

  • PDF Merging: Combine multiple PDF files into one
  • PDF Splitting: Split PDFs by specific pages or page ranges
  • Add Annotations & Images: Add text, links, images, shapes to PDFs
  • Form Operations: Read PDF form field information, fill forms, create new form elements

🔍 PDF Search & Analysis

  • Text Search: Search text in PDFs (supports regular expressions)
  • Table Detection: Find table locations and coordinates in PDFs
  • AI Invoice Parser: Extract invoice data using AI
  • PDF Information: Get detailed information including metadata, page count, security info

🔒 Security & Accessibility

  • Password Protection: Add/remove password protection to PDFs
  • Searchability: Make PDFs searchable via OCR or remove text layers
  • Attachment Extraction: Extract attachments from PDFs

💼 File Management

  • File Upload: Upload local files to PDF.co servers
  • Job Status Tracking: Monitor progress and results of asynchronous operations

⚙️ Configuration

🔑 Get API Key

  1. Sign up at PDF.co website
  2. Get your API key from the dashboard

📦 Install UV

You need to install UV (a fast Python packaging tool) to use this MCP server:

macOS and Linux
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows
powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Alternative Installation Methods
  • Homebrew: brew install uv
  • PyPI with pipx: pipx install uv
  • PyPI with pip: pip install uv

For more installation options and details, see the UV installation guide.

Connect your client

Step-by-step guides with screenshots for each client are on developer.pdf.co:

Any other client that runs local MCP servers over STDIO uses the same three values: the command uvx, the argument pdfco-mcp, and the environment variable X_API_KEY. In JSON form:

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

Desktop apps often do not see your terminal's PATH; if the server fails to start, use the full path to uvx as the command. uvx keeps the version it first resolved, so run uvx pdfco-mcp@latest once to pick up a new release.

🔧 Available Tools

PDF Conversion Tools

  • pdf_to_json: Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved
  • pdf_to_csv: Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables
  • pdf_to_text: Convert PDF and scanned images to text with layout preserved
  • pdf_to_xls: Convert PDF and scanned images to XLS (Excel 97-2003) format
  • pdf_to_xlsx: Convert PDF and scanned images to XLSX (Excel 2007+) format
  • pdf_to_xml: Convert PDF and scanned images to XML format
  • pdf_to_html: Convert PDF and scanned images to HTML format
  • pdf_to_image: Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF)

Document to PDF Conversion Tools

  • document_to_pdf: Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF
  • csv_to_pdf: Convert CSV or spreadsheet files (XLS, XLSX) to PDF
  • image_to_pdf: Convert various image formats (JPG, PNG, TIFF) to PDF
  • webpage_to_pdf: Convert external webpage URL to PDF
  • html_to_pdf: Convert HTML to PDF
  • email_to_pdf: Convert email to PDF

Excel Conversion Tools

Retirement Notice — January 5, 2027

The following Excel conversion tools are scheduled for retirement on January 5, 2027, following the discontinuation of their underlying PDF.co API endpoints: excel_to_csv, excel_to_json, excel_to_html, excel_to_txt, excel_to_xml. These tools will remain available until the retirement date. After January 5, 2027, requests to their underlying API endpoints will no longer be supported. excel_to_pdf is not affected.

  • excel_to_csv: Convert Excel(XLS, XLSX) to CSV (retiring January 5, 2027)
  • excel_to_json: Convert Excel(XLS, XLSX) to JSON (retiring January 5, 2027)
  • excel_to_html: Convert Excel(XLS, XLSX) to HTML (retiring January 5, 2027)
  • excel_to_txt: Convert Excel(XLS, XLSX) to TXT (retiring January 5, 2027)
  • excel_to_xml: Convert Excel(XLS, XLSX) to XML (retiring January 5, 2027)
  • excel_to_pdf: Convert Excel(XLS, XLSX) to PDF

PDF Editing Tools

  • pdf_add_annotations_images_fields: Add text, images, forms, other PDFs, fill forms, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files
  • pdf_merge: Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF
  • pdf_split: Split a PDF into multiple PDF files using page indexes or page ranges

PDF Form Tools

  • read_pdf_forms_info: Extracts information about fillable PDF fields from an input PDF file
  • fill_pdf_forms: Fill existing form fields in a PDF document
  • create_fillable_forms: Create new fillable form elements in a PDF document

PDF Search Tools

  • find_text: Find text in PDF and get coordinates. Supports regular expressions
  • find_table: Find tables in PDF and get their coordinates

PDF Analysis Tools

  • ai_invoice_parser: AI Invoice Parser: Extracts data from invoices using AI
  • extract_attachments: Extracts attachments from a source PDF file
  • pdf_info_reader: Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more

PDF Security Tools

  • pdf_add_password: Add password protection to a PDF file
  • pdf_remove_password: Remove password protection from a PDF file

PDF Searchability Tools

  • pdf_make_searchable: Convert scanned PDF documents or image files into a text-searchable PDF. Runs OCR and adds an invisible text layer that can be used for text search
  • pdf_make_unsearchable: Make existing PDF document non-searchable by removing the text layer from it

File Management Tools

  • upload_file: Upload a file to the PDF.co API
  • get_job_check: Check the status and results of a job. Status can be: working, success, failed, aborted, or unknown
  • wait_job_completion: Wait for a job to complete

📖 Usage Examples

Convert PDF to Text

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

Merge Multiple Images into PDF

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

Search for Specific Text in PDF

Find the word "contract" in this PDF document

Fill PDF Form Fields

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

Convert Web Page to PDF

Convert https://example.com webpage to PDF

Extract Invoice Data

Extract invoice information from this PDF using AI

Add Password Protection

Add password protection to this PDF file

📞 Support & Contact

📄 License

This project is distributed under the MIT License.

Note: A valid PDF.co API key is required to use this tool. Create a free account at PDF.co to get your API key.

来源：README.md，提交 b5de877

工具

38

pdf_to_json

Pdf To Json

Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved using the /pdf/convert/to/json2 endpoint. Ref: https://developer.pdf.co/api/pdf-to-json/basic.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_csv

Pdf To Csv

Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables. Ref: https://developer.pdf.co/api/pdf-to-csv.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_text

Pdf To Text

Convert PDF and scanned images to text with layout preserved. Ref: https://developer.pdf.co/api/pdf-to-text/basic.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_xls

Pdf To Xls

Convert PDF and scanned images to XLS (Excel 97-2003) format. Ref: https://developer.pdf.co/api/pdf-to-excel/xls.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_xlsx

Pdf To Xlsx

Convert PDF and scanned images to XLSX (Excel 2007+) format. Ref: https://developer.pdf.co/api/pdf-to-excel/xlsx.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_xml

Pdf To Xml

Convert PDF and scanned images to XML format. Ref: https://developer.pdf.co/api/pdf-to-xml.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_html

Pdf To Html

Convert PDF and scanned images to HTML format. Ref: https://developer.pdf.co/api/pdf-to-html.md

输入参数url必填langnamerectpagesunwrapapi_keypasswordprofilesexpirationhttppasswordhttpusername另有 1 个

pdf_to_image

Pdf To Image

Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF). Ref: - https://developer.pdf.co/api/pdf-to-image/jpg.md - https://developer.pdf.co/api/pdf-to-image/png.md - https://developer.pdf.co/api/pdf-to-image/webp.md - https://developer.pdf.co/api/pdf-to-image/tiff.md

输入参数url必填langnamerecttypepagesunwrapapi_keypasswordprofilesexpirationhttppassword另有 2 个

document_to_pdf

Document To Pdf

Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF. Ref: https://developer.pdf.co/api/pdf-from-document/doc.md

输入参数url必填namepagesapi_keyautosizeprofilesexpirationhttppasswordhttpusername

csv_to_pdf

Csv To Pdf

Convert CSV or spreadsheet files (XLS, XLSX) to PDF. Ref: https://developer.pdf.co/api/pdf-from-document/csv.md

输入参数url必填namepagesapi_keyautosizeprofilesexpirationhttppasswordhttpusername

image_to_pdf

Image To Pdf

Convert various image formats (JPG, PNG, TIFF) to PDF. Ref: https://developer.pdf.co/api/pdf-from-image.md ```

输入参数url必填namepagesapi_keyprofilesexpirationhttppasswordhttpusername

webpage_to_pdf

Webpage To Pdf

Convert external webpage URL to PDF. Ref: https://developer.pdf.co/api/pdf-from-url.md The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them: - date: formatted print date - title: document title - url: document location - pageNumber: current page number - totalPages: total pages in the document - img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string. For example, the following markup will generate Page N of NN page numbering: ```html <span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>

输入参数url必填namefooterheaderapi_keymarginsprofilesmediaTypepaperSizeexpirationorientationhttppassword另有 3 个

html_to_pdf

Html To Pdf

Convert HTML to PDF. Ref: https://developer.pdf.co/api/pdf-from-html/convert.md The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them: - date: formatted print date - title: document title - url: document location - pageNumber: current page number - totalPages: total pages in the document - img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string. For example, the following markup will generate Page N of NN page numbering: ```html <span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>

输入参数html必填namefooterheaderapi_keymarginsprofilesmediaTypepaperSizeexpirationorientationhttppassword另有 3 个

email_to_pdf

Email To Pdf

Convert email to PDF. Ref: https://developer.pdf.co/api/pdf-from-email.md

输入参数url必填api_keymarginsprofilespaperSizeexpirationorientationembedAttachmentsconvertAttachments

excel_to_csv

Excel To Csv

Convert Excel(XLS, XLSX) to CSV. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/csv.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

excel_to_json

Excel To Json

Convert Excel(XLS, XLSX) to JSON. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/json.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

excel_to_html

Excel To Html

Convert Excel(XLS, XLSX) to HTML. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/html.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

excel_to_txt

Excel To Txt

Convert Excel(XLS, XLSX) to TXT. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/text.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

excel_to_xml

Excel To Xml

Convert Excel(XLS, XLSX) to XML. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/xml.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

excel_to_pdf

Excel To Pdf

Convert Excel(XLS, XLSX) to PDF. Ref: https://developer.pdf.co/api/convert-from-excel/pdf.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusernameworksheetIndex

get_job_check

Get Job Check

Check the status and results of a job Status can be: - working: background job is currently in work or does not exist. - success: background job was successfully finished. - failed: background job failed for some reason (see message for more details). - aborted: background job was aborted. - unknown: unknown background job id. Available only when force is set to true for input request.

输入参数job_id必填api_key

wait_job_completion

Wait Job Completion

Wait for a job to complete

输入参数job_id必填api_keytimeoutinterval

upload_file

Upload File

Upload a file to the PDF.co API

输入参数api_keyfile_path必填

pdf_merge

Pdf Merge

Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF. Ref: https://developer.pdf.co/api/merge/various-files.md

输入参数url必填nameapi_keyprofilesexpirationhttppasswordhttpusername

pdf_split

Pdf Split

Split a PDF into multiple PDF files using page indexes or page ranges. Ref: https://developer.pdf.co/api/pdf-split/by-pages.md

输入参数url必填namepages必填api_keypasswordprofilesexpirationhttppasswordhttpusername

read_pdf_forms_info

Read Pdf Forms Info

Extracts information about fillable PDF fields from an input PDF file. Ref: https://developer.pdf.co/api/forms/info-reader.md

输入参数url必填api_keypasswordprofilesexpirationhttppasswordhttpusername

fill_forms

Fill Forms

Fill existing form fields in a PDF document. Example fields format: [ { "fieldName": "field_name_from_form_info", "pages": "1", "text": "Value to fill" } ] Use 'read_pdf_forms_info' first to get the fieldName values of the form. Ref: https://developer.pdf.co/api/pdf-add.md

输入参数url必填namefields必填api_keyprofilesexpirationhttppasswordhttpusername

create_fillable_forms

Create Fillable Forms

Create new fillable form elements in a PDF document. Example annotations format: [ { "text": "prefilled text", "x": 10, "y": 30, "size": 12, "pages": "0-", "type": "TextField", "id": "textfield1" }, { "x": 100, "y": 150, "size": 12, "pages": "0-", "type": "Checkbox", "id": "checkbox1" } ] Ref: https://developer.pdf.co/api/pdf-add.md

输入参数url必填nameapi_keyprofilesexpirationannotations必填httppasswordhttpusername

find_text

Find Text

Find text in PDF and get coordinates. Supports regular expressions. Ref: https://developer.pdf.co/api/pdf-find/basic.md

输入参数url必填pagesapi_keypasswordprofilesexpirationregexSearchhttppasswordhttpusernamesearchString必填wordMatchingMode

find_table

Find Table

Find tables in PDF and get their coordinates. Ref: https://developer.pdf.co/api/pdf-find/table.md

输入参数url必填pagesapi_keypasswordprofilesexpirationhttppasswordhttpusername

pdf_make_searchable

Pdf Make Searchable

Convert scanned PDF documents or image files into a text-searchable PDF. Runs OCR and adds an invisible text layer that can be used for text search. Ref: https://developer.pdf.co/api/pdf-change-text-searchable/searchable.md

输入参数url必填langnamepagesapi_keypasswordprofilesexpirationhttppasswordhttpusername

pdf_make_unsearchable

Pdf Make Unsearchable

Make existing PDF document non-searchable by removing the text layer from it. Ref: https://developer.pdf.co/api/pdf-change-text-searchable/unsearchable.md

输入参数url必填namepagesapi_keypasswordprofilesexpirationhttppasswordhttpusername

pdf_add_password

Pdf Add Password

Add password protection to a PDF file. Ref: https://developer.pdf.co/api/pdf-password/add.md

输入参数url必填nameapi_keypasswordprofilesexpirationhttppasswordhttpusernameprint_qualityuser_passwordowner_password必填allow_fill_forms另有 7 个

pdf_remove_password

Pdf Remove Password

Remove password protection from a PDF file. Ref: https://developer.pdf.co/api/pdf-password/remove.md

输入参数url必填nameapi_keypasswordprofilesexpirationhttppasswordhttpusername

pdf_info_reader

Pdf Info Reader

Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more. Ref: https://developer.pdf.co/api/pdf-info-reader.md

输入参数url必填api_keypasswordprofilesexpirationhttppasswordhttpusername

ai_invoice_parser

Ai Invoice Parser

AI Invoice Parser: Extracts data from invoices using AI. Ref: https://developer.pdf.co/api/ai-invoice-parser.md

输入参数url必填api_key

extract_attachments

Extract Attachments

Extracts attachments from a source PDF file. Ref: https://developer.pdf.co/api/pdf-extract-attachments.md

输入参数url必填api_keypasswordprofilesexpirationhttppasswordhttpusername

pdf_add_annotations_images_fields

Pdf Add Annotations Images Fields

Add text, images, forms, other PDFs, fill forms, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files. This tool supports three main ways to add content: 1. **annotations**: Add text, links, shapes, etc. Properties: text, x, y, size, pages, color, link, fontName, fontItalic, fontBold, fontStrikeout, fontUnderline 2. **images**: Add images or other PDF content Properties: url, x, y, width, height, pages 3. **fields**: Fill existing form fields Properties: fieldName, pages, text, fontName, size, fontBold, fontItalic, fontStrikeout, fontUnderline Example annotations: [{"text": "Sample Text - Click here to test link", "x": 250, "y": 240, "size": 24, "pages": "0-", "color": "CCBBAA", "link": "https://pdf.co/", "fontName": "Comic Sans MS", "fontItalic": true, "fontBold": true, "fontStrikeout": false, "fontUnderline": true}] Example images: [{"url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png", "x": 270, "y": 150, "width": 159, "height": 43, "pages": "0"}] Example fields: [{"fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]", "pages": "1", "text": "Joan B.", "fontName": "Arial", "size": 6, "fontBold": true, "fontItalic": true, "fontStrikeout": true, "fontUnderline": true}] Ref: https://developer.pdf.co/api/pdf-add.md

输入参数url必填namefieldsimagesapi_keyencryptflattenpasswordprofilesexpirationannotationshttppassword另有 1 个

版本历史

1
  1. v0.0.11最新Oct 22, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分