← 返回目录

PDF Reader MCP

社区

为 AI 代理提供可验证证据的 PDF 智能层。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 64 / 230
Stars: ★ 1.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 10 天前
工具数: 3

61FMRS · C

来源显示该项目专注于证据优先的 PDF 读取与验证，功能覆盖文本、表格、OCR、视觉证据和信任报告；但 README 同时说明纯 Rust 实现仍在开发中，且版本信息存在差异。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

14/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: README 描述了 read_pdf、search_pdf 和 pdf_evidence 及失败关闭策略，但清单仅声明 stdio 包，没有提供工具模式、初始化握手、错误处理或实际测试文件。清单版本 4.1.2 与 README 所称稳定版本 3.2.2 不一致，降低了可复现性和行为一致性的信心。按静态校准，缺少可核验的 CI 工作流和关键路径测试，因此不超过 12 分。
安全与权限 14/20: 材料显示其默认本地优先，URL 加载具有主机、私有 IP、大小和 HTTP 策略限制，OCR 与视觉提供商由部署环境配置，且请求不能指定任意可执行文件或提供商 URL。这些设计支持较好的边界控制。扣分原因是没有展示实现代码、默认权限、确认机制、日志中的数据处理方式或实际网络策略，且配置命令提供商和 URL 加载仍可能扩大数据边界。
维护活跃度 14/20: 项目未归档，声明有 4.1.2 清单版本、MIT 许可证、CI、测试、基准和 GitHub Issues，并明确了维护者组织与 npm 发布路径，说明存在维护基础。扣分原因是材料没有提交频率、依赖更新记录、漏洞响应流程、维护承诺或问题响应证据；README 与清单版本也存在不一致。
文档质量 14/20: README 提供了多种客户端安装示例、工具用途、输入输出示例、能力矩阵、提供商配置、安全模型、限制说明和文档入口，覆盖面较好。扣分原因是 README 的 3.2.2 稳定版本与清单 4.1.2 冲突，许多能力仅标为 provider-ready 或 partial，且没有充分说明认证、成本、资源上限、平台差异和可复核的故障排查步骤。
安装易用性 11/20: 提供了 Claude、通用 stdio、Claude Desktop、Docker 和库导入示例，主流程较清晰。扣分原因是要求 Node.js >=22.13，默认依赖平台原生可选包并在缺失时失败关闭，跨平台原生二进制尚未完成，且 TypeScript 回滚需要环境变量；这些都增加了安装失败和客户端适配成本。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件

适合谁

需要可引用页面证据的研究和分析代理。
需要表格、布局和视觉证据的 PDF 工作流。
需要本地优先文档处理和信任报告的团队。

不适合谁

只需要简单纯文本转储的场景。
需要仓库未声明功能的完整纯 Rust Document Twin 能力；README 明确称纯 Rust 仍在开发中。
需要未由来源说明的远程认证、写入或协作功能。

所需权限

服务器需要读取请求中提供的本地 PDF 路径。
如果使用 URL 加载，需要符合服务器配置的主机、私有 IP、大小和 HTTP 策略。
OCR 和视觉增强提供商由部署环境变量配置；请求体不能指定任意可执行文件或任意提供商 URL。

风险与副作用

PDF 中可能包含恶意、误导性或类似提示注入的内容。
隐藏文本、近乎不可见文字、重叠文字、不安全链接和疑似涂黑内容可能影响提取结果。
OCR、表格和视觉分析可能产生低置信度结果，应结合页面渲染或区域裁剪复核。
README 的产品版本说明与服务器清单版本不同，安装时应确认所需版本。

安装接入

准备工作

运行环境：Node.js

MCP_API_KEY 可选密钥仅在使用非默认回环的 HTTP 传输时需要设置；本地 stdio 模式无需任何密钥。

将配置加入 Claude Desktop 的 claude_desktop_config.json：使用 npx 启动 @sylphx/[email protected]。服务器通过 stdio 运行。也可在支持 MCP 的客户端中使用相同的 npx 命令。README 另提供了 3.2.2 的稳定版安装示例；仓库清单当前标注版本为 4.1.2。

claude_desktop_config.json

{"mcpServers":{"pdf-reader":{"command":"npx","args":["@sylphx/[email protected]"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "pdf-reader": {
      "command": "npx",
      "args": [
        "@sylphx/[email protected]"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add pdf-reader -- npx @sylphx/[email protected]

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置 npx -y @sylphx/citra 后重启，确认工具列表出现 read_pdf、search_pdf、pdf_evidence；再用 read_pdf 读取一个本地 PDF，若返回带页码和 bbox 的结构化结果即说明连接成功。

常见排障

确认客户端支持 stdio MCP。
确认使用的 npx 包名为 @sylphx/pdf-reader-mcp，并核对版本。
使用绝对 PDF 路径，并确认客户端进程有读取权限。
扫描文档为空时，检查 OCR 提供商及 MCP_PDF_OCR_* 环境变量配置。
证据不足时，先调用 search_pdf，再用 pdf_evidence 的 render_page 或 extract_regions 验证来源区域。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取本地 PDF 文件 /path/to/report.pdf，提取第 1 页的表格并给出页码和坐标引用。
在 /path/to/report.pdf 里搜索 "revenue" 一词，返回所有出现的页码和 bounding box。
对 /path/to/scan.pdf 的第 2-3 页运行 OCR，并给出每段文字的页面位置证据。
检查 /path/to/contract.pdf 第 4 页某个表格区域，确认单元格数量和置信度。

工具能力 3

read_pdf 只读

读取 PDF，自动选择提取路径，并返回 Markdown、文本、表格、分块、文档地图及相关报告。

search_pdf 只读

搜索可选文本及可选 OCR 文本，并返回片段、偏移量、页面、边界框和来源信息。

pdf_evidence 只读

执行检查、页面渲染、区域提取、OCR 页面处理和区域分析，以验证 PDF 中的具体证据。

使用场景

读取并总结数字 PDF。

搜索术语后通过页面和边界框验证原文。

提取表格、引用分块和结构化文档内容。

处理扫描 PDF 的 OCR 及其词框来源信息。

检查隐藏文本、可疑内容和不安全链接。

支持客户端

Claude Desktop

Claude Code部分支持

Cursor部分支持

VS Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

PDF Reader MCP 是一个本地优先的 PDF MCP 服务器，通过 Agent Document Twin 提供 Markdown、结构化元素、表格、文档地图、引用分块、页面与边界框证据、视觉裁剪、OCR 来源信息、信任报告和可访问性报告。

PDF Reader MCP

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 3

使用场景

支持客户端

详细介绍

同类可选方案