适合谁
- 需要可引用页面证据的研究和分析代理。
- 需要表格、布局和视觉证据的 PDF 工作流。
- 需要本地优先文档处理和信任报告的团队。
P
61FMRS · C
来源显示该项目专注于证据优先的 PDF 读取与验证，功能覆盖文本、表格、OCR、视觉证据和信任报告；但 README 同时说明纯 Rust 实现仍在开发中，且版本信息存在差异。
PDF Reader MCP 是一个本地优先的 PDF MCP 服务器，通过 Agent Document Twin 提供 Markdown、结构化元素、表格、文档地图、引用分块、页面与边界框证据、视觉裁剪、OCR 来源信息、信任报告和可访问性报告。
工具能力
read_pdf
读取 PDF，自动选择提取路径，并返回 Markdown、文本、表格、分块、文档地图及相关报告。
search_pdf
搜索可选文本及可选 OCR 文本，并返回片段、偏移量、页面、边界框和来源信息。
pdf_evidence
执行检查、页面渲染、区域提取、OCR 页面处理和区域分析，以验证 PDF 中的具体证据。
安装接入
将配置加入 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]"]}}}
选型与风险
不适合谁
- 只需要简单纯文本转储的场景。
- 需要仓库未声明功能的完整纯 Rust Document Twin 能力；README 明确称纯 Rust 仍在开发中。
- 需要未由来源说明的远程认证、写入或协作功能。
所需权限
- 服务器需要读取请求中提供的本地 PDF 路径。
- 如果使用 URL 加载，需要符合服务器配置的主机、私有 IP、大小和 HTTP 策略。
- OCR 和视觉增强提供商由部署环境变量配置；请求体不能指定任意可执行文件或任意提供商 URL。
风险与副作用
- PDF 中可能包含恶意、误导性或类似提示注入的内容。
- 隐藏文本、近乎不可见文字、重叠文字、不安全链接和疑似涂黑内容可能影响提取结果。
- OCR、表格和视觉分析可能产生低置信度结果，应结合页面渲染或区域裁剪复核。
- README 的产品版本说明与服务器清单版本不同，安装时应确认所需版本。
常见排障
- 确认客户端支持 stdio MCP。
- 确认使用的 npx 包名为 @sylphx/pdf-reader-mcp，并核对版本。
- 使用绝对 PDF 路径，并确认客户端进程有读取权限。
- 扫描文档为空时，检查 OCR 提供商及 MCP_PDF_OCR_* 环境变量配置。
- 证据不足时，先调用 search_pdf，再用 pdf_evidence 的 render_page 或 extract_regions 验证来源区域。
使用场景
读取并总结数字 PDF。
搜索术语后通过页面和边界框验证原文。
提取表格、引用分块和结构化文档内容。
处理扫描 PDF 的 OCR 及其词框来源信息。
检查隐藏文本、可疑内容和不安全链接。
支持客户端
Claude Desktop完整支持
Claude Code部分支持
Cursor部分支持
VS Code部分支持
Any MCP client部分支持