pdf-reader-mcp

让 AI 看懂 PDF：结构化提取、表格 OCR、带页码引用，本地运行。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 93 🐛 待处理 10 👀 关注 3

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1066

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，本地部署，完全免费。

项目预览

项目数据

分类智能体

开发团队SylphxAI

官网地址https://sylphxai.github.io/anymd

GitHubhttps://github.com/SylphxAI/anymd

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，本地部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型ai-agents,cli,document-conversion,docx,docx-to-markdown,epub,html-to-markdown,llm,markdown,markitdown-alternative,mcp,model-context-protocol,ocr,pdf,pdf-to-markdown,pptx,rag,rust,transcription,xlsx

GitHub 星标★ 1066

上线时间2025-04-04 00:00:00

代码更新2026-11-07

仓库体积24.5 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

pdf-reader-mcp 是一个基于 MCP（模型上下文协议）的 PDF 阅读工具，旨在为 AI 智能体提供“眼睛”，使其能够深入理解 PDF 文档。它通过 Rust 原生实现，支持本地优先处理，能提取结构化文本、表格数据，并具备 OCR 识别能力，同时提供视觉证据和页面级引用，让 AI 的回答有据可查。该工具解决了 LLM 在处理 PDF 时常见的格式混乱、信息丢失和难以引用来源的问题，核心能力包括精准的版面解析、多模态内容识别（文本/表格/图像）、以及将提取内容与页面位置关联，便于追溯。它作为 MCP 服务器，可无缝集成到支持 MCP 的 AI 应用（如 Claude、Cursor 等）中，增强其文档理解能力。项目处于早期阶段，但已获得近千星标，显示出社区对高质量 PDF 解析工具的强烈需求。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1066

技术标签

ai-agents cli docx epub html-to-markdown

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 18 或更高版本（npm 会按平台自动安装原生二进制）
若使用 Docker 方式：已安装 Docker（支持 amd64 与 arm64）
若从源码编译：Rust 1.95+、CMake 和 C++ 编译器
Python 方式需可用的 uvx / pip 环境

安装与启动步骤

1一键配置 MCP 客户端

自动把 anymd 添加到本机所有支持的 MCP 客户端（Claude Code、Codex、Cursor、VS Code、Claude Desktop、Windsurf、Gemini CLI）。可加 --dry-run 预览、--remo
```
npx -y @sylphx/anymd setup
```
2或手动添加服务器

每个 MCP 客户端执行的都是同一条命令。以 Claude Code 为例，也可用该命令手动注册 anymd 服务器。
```
claude mcp add anymd -- npx -y @sylphx/anymd
```
3命令行转换文件

不配置 MCP 也可直接用 CLI，把 PDF 等文件转成 Markdown 输出到标准输出。
```
npx -y @sylphx/anymd report.pdf > report.md
```
4全局安装 CLI

想反复使用可全局安装，安装后直接以 anymd 命令调用。
```
npm install -g @sylphx/anymd
```
5Python 方式运行

Python 用户可用 uvx 单次运行，或 pip 安装；uvx anymd mcp 可启动 MCP 服务器。wheel 内置同一份预编译二进制。
```
uvx anymd report.pdf > report.md
pip install anymd
uvx anymd mcp
```
6Docker 方式运行

挂载当前目录到 /data 做转换；去掉文件参数并以 -i 启动即为 stdio 模式的 MCP 服务器。
```
docker run --rm -v "$PWD:/data" ghcr.io/sylphxai/anymd report.pdf > report.md
docker run -i --rm ghcr.io/sylphxai/anymd
```
7从源码编译安装

从 crates.io 编译安装，需要 Rust 1.95+、CMake 与 C++ 编译器；包含 doc-VLM OCR 和本地 ASR。
```
cargo install anymd
```

关键配置

配置项	必填	说明	示例
`mcpServers.anymd.command`	是	MCP 客户端启动服务器所用的可执行命令	`npx`
`mcpServers.anymd.args`	是	传给启动命令的参数数组，-y 表示免确认安装	`["-y", "@sylphx/anymd"]`
`--allow-dir`	否	把服务器可访问范围限制在指定目录内	`--allow-dir=/path/to/docs`
`servers.anymd.type`	否	VS Code 配置中声明的传输类型，stdio 表示标准输入输出	`stdio`

如何确认成功

在 MCP 客户端中能看到 anymd 服务器并调用其工具，或执行 anymd report.pdf 后正常输出 Markdown 内容，即表示安装成功。

常见问题

Q：使用需要 API key 吗？

A：不需要。anymd 是本地优先的 Rust 实现，全部处理都在你自己的机器上完成，README 明确说明无需 API key。

Q：如何撤销一键 setup 写入的配置？

A：重新执行 setup 命令并加上 --remove 参数即可回滚；如果只想先看看会改哪些客户端，可先加 --dry-run 预览。

Q：应该选 npm、pip、Docker 还是 cargo？

A：npm、pip 和 Docker 都分发预编译二进制，开箱即用；cargo install 会在本机现场编译，需要 Rust 1.95+、CMake 和 C++ 编译器。

Q：支持处理哪些文件格式？

A：除 PDF 外还包括 Word、PowerPoint、Excel、EPUB、HTML 与网页、图片（OCR），以及音频视频的元数据、字幕和转写文本。

注意事项

一次 setup 会同时写入本机所有受支持的 MCP 客户端配置，操作前可用 --dry-run 预览改动。
不指定 --allow-dir 时服务器默认可访问较大范围，处理敏感文档时建议限定目录。
镜像 ghcr.io/sylphxai/anymd 同时提供 amd64 与 arm64 版本，Docker 方式无需本机安装 Node。
项目前身为 pdf-reader-mcp，从旧版本迁移请参考官方迁移文档。

核心亮点

Rust 原生实现，解析性能高且内存安全，适合处理大型 PDF。
提供页面级引用和视觉证据，AI 回答可溯源，增强可信度。
本地优先，数据不出设备，满足隐私和合规要求。

不足之处

早期项目，API 和功能可能不稳定，文档和社区支持待观察。
依赖 MCP 生态，非 MCP 环境需额外适配。

适用场景

企业知识库问答：让 AI 基于内部 PDF 文档提供带引用的答案。
学术研究辅助：快速提取论文中的表格、图表和关键段落。
法律/合同审查：AI 定位条款并引用页码，辅助人工复核。

替代项目

MinerU、PyMuPDF、Unstructured

上一篇：hermes-hud

下一篇：ScienceClaw