---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
datePublished: 2026-11-11
title: 通过 PDFCraft MCP 将 PDF 转为 Markdown
description: 为 AI Agent 接入 PDFCraft MCP，用示例 PDF 完成 Markdown 转换、检查结果，再将文本用于摘要和文档处理。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/blog/pdfcraft-mcp/
markdown_url: https://oomol.com/zh-cn/blog/pdfcraft-mcp.md
---

![自然光下翻阅书籍的读者，配文让阅读超越 PDF](/blog/pdfcraft-mcp/zh-cn-cover.webp)

PDF 报告可以成为 AI Agent 的参考材料。先将它转为 Markdown，你就能检查、编辑并复用其中的文本，再让 Agent 整理摘要或提取信息。

[PDFCraft](https://pdfcraft.ai/zh-CN/) 提供处理 PDF 和 EPUB 的远程 MCP 服务。本文用一个小型公开 PDF，说明从接入到检查下载结果的完整流程。转换会消耗 PDFCraft credits。

## 为 Agent 接入 PDFCraft

在 [OOMOL Console](https://console.oomol.com/api-key) 创建 API key，再按照 [PDFCraft MCP 接入指南](https://pdfcraft.ai/zh-CN/docs/getting-started/mcp/)添加服务器。PDFCraft 使用独立的 MCP 地址；如果已经接入 OOMOL Apps，需要另外添加这个服务器。

开始前，核对客户端是否支持接入指南列出的传输方式、协议版本和 Bearer 认证请求头。将密钥保存在客户端的凭据设置中。客户端还需要能够读取并上传文件内容：把本地文件名告诉远程服务器，并不会上传文档。

让 Agent 调用 `get_capabilities`，说明当前支持的转换格式。如果它无法发现工具，先解决连接问题，再上传文件或启动付费任务。

## 从一页 PDF 开始

下载并打开 [PDFCraft 示例 PDF](https://pdfcraft.ai/examples/api-quickstart.pdf)。文件包含 `Paper to structured text.`，可以用这句话检查转换结果。这是用于练习的小型输入文件，不能用来评估扫描书籍、表格或公式的识别质量。

通过客户端的附件入口提供 PDF，或将它放在 Agent 能读取的工作目录中，然后提出请求：

> 使用 PDFCraft，准备将附件中的示例 PDF 转成 Markdown。先检查支持的选项和我的余额，估算转换费用，在开始处理前把估算结果给我看。保留任务 UUID，方便之后继续查询同一个任务。

查看费用估算，确认后再授权开始处理：

> 开始转成 Markdown，间隔查询进度直到完成，然后把完整结果下载到当前工作目录。告诉我任务 UUID 和文件保存位置。如果失败，先展示错误，不要直接创建另一个任务。

服务的处理流程是创建任务、上传文件、启动处理、查询进度，再获取下载链接。能发现工具，并不代表上传或转换已经成功。在保存并检查结果前，请保留任务 UUID。

## 先检查结果，再生成摘要

打开下载结果。如果是压缩包，先解压，再检查 Markdown 和附带的资源文件。可以让 Agent 执行：

> 打开转换后的 Markdown，检查是否包含“Paper to structured text.”。展示对应段落，并与示例 PDF 对照。如果缺少文字，请指出，不要自行补全。

找到这句话，只能初步确认输出对应预期的输入。处理自己的文档时，还应对照原文检查标题、段落顺序、表格、数字和脚注。摘要读起来通顺，也可能掩盖数字或公式的识别错误。

检查转换结果后，再让 Agent 使用保存的文本：

> 根据这份 Markdown 整理五点摘要。每一点附上一小段原文作为依据，有标题时注明来源标题。保留原始 Markdown，不要修改。

摘要由 Agent 根据转换结果生成，PDFCraft 提供文档处理工具。保存 Markdown 后，后续提问可以复用这份文本，无需每次重新转换同一个 PDF。

## 中断后继续查询原任务

如果处理过程中对话或客户端中断，把保存的任务 UUID 交给新的会话，让它查询原任务。不要因为看不到原会话的进度，就重新启动一次转换。

下载链接过期时，只要任务文件仍然可用，就可以为同一个任务重新获取链接。如果余额不足阻止了完整下载，充值后再请求结果。具体状态与恢复方式见 PDFCraft 的[任务生命周期与恢复指南](https://pdfcraft.ai/zh-CN/docs/api/lifecycle/)。请在文件过期前保存完成的结果。

## 转成 EPUB 或翻译文档

PDFCraft 还支持 PDF 转 EPUB，以及 PDF 或 EPUB 翻译。如果要把书放到电子阅读器中阅读，可以选择 EPUB 输出。需要翻译时，让 Agent 通过 `get_capabilities` 检查支持的语言，确认目标语言，并在处理前估算费用。

按接下来的用途选择格式：检查和复用文本时选择 Markdown，阅读书籍时选择 EPUB。处理大型文档前，先用一份有代表性的小文档检查效果。

## 将文本用于工作应用

检查 Markdown 后，你可能想把摘要保存到工作应用，或附在某个项目中。通过 [OOMOL Agent 快速开始](/zh-cn/docs/agents/)接入对应应用，并在让 Agent 写入前明确保存位置。PDFCraft 转换服务器与 OOMOL 已连接的 Apps 需要分别配置。

如果只想在浏览器中压缩、合并或拆分 PDF，可以打开 [PDFCraft 在线 PDF 工具](https://pdfcraft.ai/zh-CN/tools/)。需要由 Agent 执行转换时，从 [PDFCraft MCP 接入指南](https://pdfcraft.ai/zh-CN/docs/getting-started/mcp/)开始。
