PDF Reader MCP 現在叫 AnyMD:它在本機把文件轉成 AI 可讀的 Markdown,保留 PDF 頁碼,適合從報告找一段文字再回到原頁確認。舊套件名稱仍能安裝,但工具已換成 read、search 等名稱。只要看幾行文字,直接貼給 AI 比安裝簡單;需要反覆讀多頁 PDF,才值得接這個伺服器。
Windows 安裝與客戶端設定
需要 Node.js 18 以上。以下在新的 PowerShell 資料夾安裝相容套件 8.5.11,這個版本會啟動同版 AnyMD。
npm.cmd install --save-exact --no-audit --no-fund @sylphx/pdf-reader-mcp@8.5.11
New-Item -ItemType Directory -Force documents | Out-Null
$node = (Get-Command node.exe).Source
$entry = (Resolve-Path .\node_modules\@sylphx\pdf-reader-mcp\bin\pdf-reader-mcp.js).Path
$docs = (Resolve-Path .\documents).Path
$cache = Join-Path (Get-Location) 'anymd-cache'
Claude Code:
claude.cmd mcp add pdf --scope project --env "ANYMD_CACHE_DIR=$cache" -- $node $entry "--allow-dir=$docs"
claude.cmd mcp list
Codex:
codex mcp add pdf --env "ANYMD_CACHE_DIR=$cache" -- $node $entry "--allow-dir=$docs"
codex mcp list
Claude 的健康檢查應顯示 Connected;重新開啟 AI 工作階段後再下文件任務。--allow-dir 只開放 documents,快取另放在目前專案。沒有執行會一次更改多個客戶端的 setup 命令。
Cursor 可依上游 Cursor 設定,在 .cursor/mcp.json 使用 mcpServers,指定相同 Node 執行檔、入口及 --allow-dir。原生 Windows 執行檔由 npm 的平台相依套件提供,不需要另外編譯 Rust。
準備一份看得出頁碼的範例
你可以使用自己的文字 PDF。想重現下面結果,可用 uv 建立兩頁範例:
uv venv --python 3.12 .venv
uv pip install --python .\.venv\Scripts\python.exe reportlab==5.1.0
將這段存成 make_pdf.py,再執行 .\.venv\Scripts\python.exe make_pdf.py:
from reportlab.pdfgen import canvas
c = canvas.Canvas('documents/sales.pdf')
c.drawString(72, 740, 'Taipei sales: 200 TWD')
c.showPage()
c.drawString(72, 740, 'Kaohsiung sales: 50 TWD')
c.save()
三個可以直接貼上的用途
1. 只讀需要的頁
只用 PDF MCP 的 read,讀 documents/sales.pdf,pages="2"、ocr=false、
images="none"。使用完整檔案路徑,保留工具回傳的頁碼,不要讀整個資料夾。
結果應含 <!-- page 2 --> 與 Kaohsiung sales: 50 TWD,不應把第一頁的 200 當成這一頁的金額。先選頁再提問,能減少無關內容進入對話。
2. 跨頁核對資料
用 read 讀同一個 sales.pdf,pages="1-2"、ocr=false、images="none"。
按原始頁碼列出城市與金額;缺資料就指出,不要自行補值。
本例第 1 頁是 Taipei/200,第 2 頁是 Kaohsiung/50。Markdown 內的頁碼標記是回查原檔的線索,不等於已驗證每個版面元素都被完整擷取。
3. 搜尋後帶著頁碼回答
用 search 搜尋 Taipei,mode="literal",sources只放這份sales.pdf的完整路徑。
列出命中頁碼與原文,再回答Taipei的銷售金額。
我們取得 1 筆命中,指向 p.1,原文包含 Taipei sales: 200 TWD。指定 literal 可明確要求字面搜尋,避免把相近主題的段落當成同一個詞的命中。
常見問題與排錯
- 找不到
read_pdf: 舊教學的單一 PDF 工具已不是 8.5.11 的介面。請讓 AI 讀取目前工具結構;本版提供outline、read、search、inspect,本例只需要中間兩個。 - 已經有文字卻出現掃描頁提示: 我們的每頁只有一行,仍收到
These pages have little or no selectable text。先看正文是否已經正確擷取,不要只因提示就下載 OCR 模型。文字稀少與完全沒有文字是不同情況。 - 找不到原生執行檔: 檢查 npm 安裝是否略過 optional dependencies;Windows x64 需要對應的
@sylphx/anymd-win32-x64-msvc。在正確平台重新安裝,不要拿 Linux 執行檔改副檔名。 - 路徑被拒絕或找不到檔案: 把 PDF 放在允許目錄,先確認完整路徑。檔名相對於 AI 的工作目錄與伺服器允許目錄不一定相同,所以範例提示詞明確要求完整路徑。
費用、範圍與替代方案
本機核心採 MIT 授權,文字 PDF 的讀取與搜尋不需要帳戶或 API key。另有付費 Pro 功能與按頁計費的託管服務;這裡用的是本機免費核心。AI 客戶端自己的用量另外計算。
掃描件需要 OCR 路線及相應軟體/模型。複雜表格、雙欄、圖片與頁面完整性要以自己的文件檢查;這個兩行範例只用來核對頁碼和文字。要建立可程式化的頁面擷取流程,可以看 PyMuPDF4LLM;需要處理多種辦公室文件,也可比較 MarkItDown 的轉檔方式。
FAQ
PDF Reader MCP 改名後,要重新建立帳戶嗎?
本機使用不需要帳戶。8.5.11 的舊 npm 名稱是 AnyMD 的相容入口,會啟動相同版本的程式。新的安裝可以直接採上游 AnyMD 名稱;現有設定最重要的是更新工具名稱與核對實際版本。
可以只讓 Claude Code 讀某幾頁嗎?
可以,read 的 pages 參數接受例如 2、1-5,8。在提示詞保留原頁碼,並要求答案附上頁碼與原文片段。本例在 Codex 以相同 MCP 介面驗證了單頁與雙頁讀取。
搜尋命中代表整份 PDF 都讀完整了嗎?
不是。字面搜尋只能證明回傳的位置有該字詞;掃描文字、未處理頁面或特殊版面可能需要其他檢查。若你要確認完整性,應先核對總頁數、讀取範圍與原檔,再對關鍵內容抽查。
我們測了什麼
2026-11-16:Windows、Node 24、相容套件與 AnyMD 8.5.11、ReportLab 5.1.0。Codex 真讀兩頁文字 PDF、指定第 2 頁、跨頁讀取與字面搜尋;Claude Code 註冊健康檢查 Connected。沒有測 OCR、付費功能、複雜表格或 Cursor。參考官方 README與改名說明,查閱日期同上。