夜雨聆风你有没有发现:让 AI 读一份 PDF,它经常一本正经地胡说?页码是编的,表格被读成一团浆糊,甚至数据都能差一位数。
更气人的是,你还很难抓住它——因为它从不告诉你'这句话是从第几页第几行来的'。
今天介绍一个冷门但思路非常清晰的开源项目 Citra(SylphxAI/pdf-reader-mcp)——它的定位一句话:给 AI 一双会看 PDF 的眼睛,而且每一页、每一格都带证据。
▎它不是什么,又是什么
先别被名字骗了:它不是一个'你拿来自己读 PDF 的阅读器',也不是又一个大而全的 RAG 框架。
Citra 是给 AI Agent 用的 PDF 阅读层,走的是 MCP(Model Context Protocol)协议——也就是装在 AI 客户端里,让 Claude Code、Cursor 这些工具突然'会读 PDF'的那层能力。
Plain-text PDF tools make agents guess. Citra returns an Agent Document Twin they can cite.— 项目 README 原文:'纯文本 PDF 工具让 AI 靠猜;Citra 返回一份它们能引用的文档孪生体。'
翻译成人话:以前 AI 读 PDF 是'大概读一读、然后全靠编'。Citra 是'读到哪、引用到哪、坐标都在哪'——读到表格就给你行列单元格,读到扫描件就给你 OCR,所有结论都挂在页码和坐标上。
上图就是它的结构:左边是 Claude Code、Cursor、Codex 等 AI 客户端,通过 MCP/stdio 接到中间这个纯 Rust 写的本地解析引擎,输出右侧'可引用证据'——页号+坐标,不再瞎编。
▎为什么你也会需要它
不管你是研究助理、金融民工,还是写代码的人,只要你的 AI 要接触 PDF,这就是刚需:
· 看财报:过去 AI 说'营收大约1200万',你根本不敢信;现在它告诉你'第14页,表3,第4行第2列,是1240万'
· 读论文: 标题、阅读顺序、逐页引用,引用都有页码可查
· 扫描件: OCR 不再是'一坨乱码',而是和页码绑定的证据链
▎里面有什么:三个工具,一个表面
Citra 刻意只做三件事(官方叫'few clear tools 原则'):
· read_pdf — 默认全能:结构化文本、表格、OCR、引用,一条调用全给
· search_pdf — 先搜后读:在文章里定位页面和片段,再决定要不要精读
· pdf_evidence — 证据专用:裁剪、渲染、逐区域查看,盯着原始证据干活
工具少,意味着 AI 不会选错;每个工具都返回带页码/坐标的结论,AI 可以拿着它向人类'交作业'。
▎怎么上手:一条命令
没有 Docker、没有 API Key、没有全局安装。任意 Agent 环境,一行搞定:
npx -y @sylphx/citra
Claude Code 里加:claude mcp add citra -- npx -y @sylphx/citra;Claude Desktop / Cursor / VS Code 填一段 JSON 就行。装完就有 read_pdf / search_pdf / pdf_evidence 三个工具。
安装体积极其克制:node_modules 从 82MB 压到 24MB,安装文件数从 4101 个减到 20 个(纯 Rust 内核,TS 时代的纸面负担几乎清零)。官方自测:暖启动场景延迟中位数提升约 10 倍。
▎隐私:本地优先,PDF 不出机器
这是它的核心卖点之一:
· PDF 全部在本地解析,不需要 OCR 云服务或视觉 API
· 纯 Rust 引擎,单机解析,数据链路短
· 没有隐藏的遥测回传:缺本地原生二进制时直接'失败关闭'(fail closed),绝不静默降级到云端
· MIT 协议,代码全开,想审计随时可以
▎怎么接入你的 AI 生态
Citra 走的 MCP 是当前 AI 生态的事实标准协议:Claude Code、Cursor、Codex、Gemini CLI 全都认。
它同门还有一整个'乐器家族':Iris(图像)、Cue(视频)、Spine、Lookout、Locus——同一个 SylphxAI 组织的兄弟项目,以后图文/视频证据也可以串成一个体系。
对国内用户:核心依赖 npm(npx),配个镜像源即可;PDF 不出境,配合 DeepSeek 等国产模型使用时,文档数据更安心。
————————————
一句话总结:Citra 解决的不是'AI 读不读得懂 PDF',而是'AI 说的话敢不敢让你查'——把 PDF 幻觉,变成带页码的证据链。
如果你已经在用 Claude Code / Cursor / Agent,手里堆着财报、论文、扫描合同想看,它值得你花十分钟装一下。
开源、MIT、887 星、活跃维护。趁还没烂大街,先收藏。